Onboarding and Initial Nexi Panel Configurations Print

Starting v2.3.5, we’ve introduced a feature called Setup WizardOnboardingg. This feature helps you configure the hostname for your Nexi Panel.

In favor of this feature, we will deprecate Hostname SSL and Mail Server SSL. We recommend that ratherthann using two things, you could just use the Setup wizard and it will take care of everything for you, you don’t need to issue Hostname and Mail Server SSL.

Requirements Before using

Before you use this feature, you need to do some configurations so that everything goes smoothly.

Point A recordLet'st say you are going to use server.cyberpanel.net As your hostname domain, first make sure to point this domain to your server IP address, which is usually called an A record. An example of an A record that you would need is:

server.cyberpanel.net.   IN   A      192.168.1.1

This is an example of an A record. This must be done before you use this feature.

• How to add A record to Cloudflare
• How to add A record in Namecheap
• How to add A record in GoDaddy

Please note that Nexi Panel will check if A record exists before it starts setting up thing., if the record is not present, Nexi Panel will return an error, and if you have recently created an A record you might want to weight some time to use the domain.

Configure rDNS

This is really really important. The hostname/domain you use here must also be configured as rDNS for your IP. If it is not configured Nexi Panel will return error and not continue.

• How to configure rDNS on Hetzner
• How to configure rDNS on Vultr
• How to configure rDNS on DigitalOcean
• How to configure rDNS on UpCloud
• How to configure rDNS on OVH

Once rDNS is configure you are good to go, you can use tools like Checkdns to ensure A record and rDNS are properly configured.

Important Notes

Setting up the hostname is a one-time process. If you create new domains under Nexi Panel and intend to use email services on those domains, you won’t need to go through the hostname configuration again. Once configured, email functionality for additional domains will operate smoothly without the need for further adjustments.

Debugging

Lets discuss some possible errors and their solutions.

Domain that you have provided is not configured as rDNS for your server IP. [404]

If you keep getting this error even after updating your rDNS, it is possible that your rDNS is now cached. You can overcome this by editing your /etc/resolv.conf

Let say the content of your /etc/resolv.conf is

nameserver 1.1.1.1
nameserver 8.8.8.8

Try changing it to

#nameserver 1.1.1.1
nameserver 8.8.8.8

Then again try to configure from Nexi Panel if you still get same error, altogether try a different DNS server. Like (OpenDNS servers)

nameserver 208.67.222.222
nameserver 208.67.220.220

Add above content to /etc/resolv.conf and try again.

If your rDNS is properly set, then changing the DNS server must fix this.

/etc/hosts file causing issues

I’ve recently noticed that /etc/hosts file could also cause issue with this function, please read more here.

For Advanced Users Only: What does this function do?

Only read this part if you are an advanced user.

Scenario 1:

1. This function first fetch myhostname value from /etc/postfix/main.cf
2. Then it check rDNS value of your server IP address.
3. Now if myhostname and rDNS appears to be same and the same domain also have valid SSL on the server, this function then does nothing because this is how it should be.

One important thing to note: Let say myhostname value and your rDNS are same and it also have a valid SSL, now you have provided a different domain to this function, it won’t do anything. Because this is a mistake on user end as rDNS is also configured as a myhostname value.

Scenario 2:

1. If scenario 1 fails it shifts to second approach.
2. So far it means that the domain you have provided to be configured as hostname is not set as the value of myhostname in postfix.
3. In this section it will again check if the provided hostname is also set as rDNS, if not it will return Domain that you have provided is not configured as rDNS for your server IP. [404]
4. Now if everything is good, provided domain is set as rDNS. Then Nexi Panel will issue Hostname SSL and Mail Server SSL for this hostname and also set value of myhostname in postfix to this domain.
5. Finally restart mail services