Network
The Network section of the admin menu, covering the server's hostname, the DNS resolvers it uses, the panel's own certificate and the certificates of the mail and FTP services.
The Network section of the admin menu holds the server's own name and how it looks up names. It also holds the certificates used by the panel and by the mail and FTP services.
Change Hostname#
In the admin area, open Network → Change Hostname (open). The hostname is the server's own full name, such as server1.example.com. Mail servers elsewhere look at it, so it should be a real name that resolves to this server.
To change it:
- Enter the new name under Server name.
- Click Change.
Rules:
- It must be a full name with at least two dots, such as
server1.example.com. A bareexample.comis refused. - It must not be a website hosted on this server. The server needs a name of its own.
What happens on the server: the panel sets the name with the system's own tool. If the name lies in a DNS zone hosted on this server (for example server1.example.com when example.com is hosted here), its A record is created or corrected to point at this server. If the domain's DNS is kept elsewhere, add that A record there yourself.
To check the record later, or to create it again, open Hostname Address Record in the DNS section.
The same card has Set the Clock from the Network, which switches network time on and sets the clock now (see Server Setup).
Good to know:
- For mail to be delivered reliably, the reverse DNS (PTR record) of the server's IP address should also point to the hostname. Your hosting provider or data centre sets that, not the panel.
- The panel's certificate is for the name you open the panel with. That can be the hostname or another name. See Panel Certificate below.
DNS Resolvers#
In the admin area, open Network → DNS Resolvers (open). Resolvers are the DNS servers this server asks when it looks up names itself, for example to deliver mail, check a domain or download updates. They have nothing to do with the nameservers your clients' domains use.
To change them:
- Enter one to three IP addresses, separated by commas, such as
1.1.1.1, 8.8.8.8. - Click Change.
What happens on the server: the panel rewrites /etc/resolv.conf with one nameserver line for each address. Any search, options and domain lines that were already in the file are kept.
Good to know:
- Only IP addresses are accepted, not names. At most three are used.
- If
/etc/resolv.confis a link managed by another service, the panel refuses the change and says so. Change the resolvers in that service instead. - On servers whose network is set up by the provider's tools (cloud-init, NetworkManager and similar), the provider's settings may come back after a restart. Then set the resolvers in the network configuration as well.
- Use resolvers you trust and that answer quickly. Slow resolvers slow down mail delivery.
Panel Certificate#
In the admin area, open Network → Panel Certificate (open). This page shows the certificate the panel uses on port 7443, and gets a free trusted one.
Current certificate shows whether it is Self-signed or Trusted, who issued it, the names it is valid for, and when it expires. After installation the certificate is self-signed, so browsers show a warning.
To get a trusted certificate:
- Choose the name you will open the panel with, such as
panel.example.comor the server's hostname. - Create a DNS A record for that name pointing at this server, and wait until it resolves.
- Enter the name under Panel hostname and click Get certificate. Keep the page open; this takes up to a minute.
- From then on, open the panel as
https://panel.example.com:7447/(admin and reseller areas) orhttps://panel.example.com:7443/(clients' areas).
The certificate comes from Let's Encrypt and renews automatically. Let's Encrypt checks the name over plain HTTP, so port 80 must be reachable from the internet.
Good to know:
- The name must not be a client's website. Use a name only for the panel, such as
panel.yourcompany.com. - If the name does not resolve yet, or Let's Encrypt cannot check it, nothing changes and the error says why.
- The mail and FTP servers use the same certificate by default (see Service Certificates below).
Service Certificates#
In the admin area, open Network → Service Certificates (open). This page shows the certificates of the services other than the web server: Exim (SMTP) Server, Dovecot Mail Server and FTP Server. For each one it lists the names covered, the issuer, the expiry date and the key type. It also warns when a certificate is expired or has fewer than 15 days left.
How the services choose a certificate:
- When a mail program asks for a name that a website's certificate covers (for example
mail.example.com), Exim and Dovecot present that website's certificate. The page lists these names under "Names with a certificate of their own for mail". - For any other name, each service presents its default certificate. This is the panel's trusted certificate (see Panel Certificate), and it follows that certificate when it renews.
- Until the panel has a trusted certificate, the services present the self-signed certificate made at installation.
Click Apply the current certificates to the services now to give the services the current certificates straight away, for example after a renewal. Installed Certificates opens the list of all websites' certificates.
Installing your own certificate for mail and FTP#
In the admin area, open Network → Service Certificates (open) and scroll to Install a Certificate for the Services. Use this to give the mail and FTP servers a certificate you bought elsewhere, for example a wildcard certificate. It replaces the default certificate for those services only. Websites and the panel keep their own.
- Paste the certificate under Certificate, followed by its issuer's certificates. Put the server certificate first, then the intermediate certificates, all in PEM format (
-----BEGIN CERTIFICATE-----). - Paste the matching private key under Private key.
- Click Install.
The panel checks that the key matches and tells you when the certificate expires. If the certificate does not cover the server's hostname, you get a warning, because mail programs set up with the hostname will then show a certificate warning.
To go back to the default certificate, click Remove my certificate.
Good to know:
- A certificate you install here does not renew by itself. Install the new one before it expires. The table on the same page shows the expiry date.
- Never paste a private key anywhere except into this form.
Something missing? Ask in the community or open a ticket.