Installation
Install SDM from Client Area on a verified AlmaLinux 9 server, then confirm the licensed DNS control plane before adding zones.
Where to find it: Documentation > DNS Manager > Installation.
Available to: Anyone may read this guide. Generating the command requires access to the SDM license in Client Area, and installation requires root on the target server.
What this page does
This guide defines the server and network prerequisites, uses the one-time license command from Client Area, and verifies the first SDM session. The installer validates the platform, prepares MariaDB, PowerDNS, TLS, firewall rules, and SDM services, then activates the selected license.
Requirements
| Requirement | Required state |
|---|---|
| Operating system | A clean AlmaLinux 9 server is mandatory. Other distributions and major versions are not supported. |
| Server state | For a fresh installation, no existing SDM deployment under /opt/sdm and no existing sdm or sdmd system service. |
| Access | A root shell, a working dnf configuration, and reachable AlmaLinux repositories. |
| License | The SDM license assigned to this server, with Generate install token available in Client Area. |
| Server identity | The intended hostname, a detectable primary IPv4 address, working DNS resolution, and accurate system time. |
| Network and tools | Outbound HTTPS access plus curl and bash for the initial command. External firewall rules must allow authoritative DNS on 53/tcp and 53/udp, panel access on 882/tcp, and the server's SSH port. |
The installer prepares its local firewalld baseline, including DNS, web, panel, service, and current SSH ports. Cloud firewalls and upstream security groups remain the operator's responsibility.
Install SDM
Installation command: Open Client Area > Licenses.
- Sign in to Client Area and open Licenses.
- Select the SDM license intended for this server, choose Generate install token, and confirm.
- Keep Stable selected unless Synconix Support has asked you to use another release channel.
- Copy the complete command while the token countdown is active. Client Area displays the command in this format:
curl -fsSL 'https://download.synconix.com/YOUR_INSTALL_TOKEN' | bashYOUR_INSTALL_TOKEN is a non-working placeholder. Use only the command generated for the selected license. The real token is one-time and expires; never save or share it in scripts, screenshots, tickets, or logs.
- Paste the generated command into the root shell of the intended server and run it exactly as shown.
- Wait for package installation, service configuration, and license activation to complete. Do not bypass a platform or existing-installation safety refusal.
Verify the installation
- Confirm that the installer reports completion and prints the SDM login URL on port
882. - Open the printed URL and confirm that the sign-in page responds.
- Sign in, then open Dashboard and License. Confirm the intended node identity, DNS service state, and active license before adding customer zones.
- If installation stops, read
/var/log/synconix-sdm/install.log. Generate a new token only when the previous token expired; do not reuse another license's command.
Result and next check
SDM is installed only when its services start, the panel opens on the intended server, and the correct license is active. Continue with Getting Started to secure the first account, confirm the deployment model, and verify a controlled DNS change.
Theme color