Setting Your Hostname
On the internet, servers are identified using an identifier known as a FQDN (or Fully Qualified Domain Name). An FQDN is a name given to a computer which can only be interpreted by the users in a single manner. "srv1" is an example of a name that can be treated ambiguously by other networks (as they might also have a srv1). However, if you named the server srv1.sexydomain.com, the name can only be interpreted one way (unless the network is seriously hackish). Whilst OpenPanel doesn't require that your hostname is properly configured, it is recommended to properly configure it.
In the following example, we will use the address srv1.sexydomain.com. It is comprised of the following components:
|IP address:||22.214.171.124 (this is unique to YOUR server. Use ifconfig to identify your REAL address. Generally it's listed under eth0).|
The following procedure is only tested for Debian.
- Firstly, open a terminal/bash session to your server, and ensure you are running as root (type
suto escalate if required).
echo FQDN > /etc/hostname(example command: echo srv1.sexydomain.com > /etc/hostname)
- You need to add
IPADDRESS FQDN SHORTNAMEto /etc/hosts. It should look something like:
126.96.36.199 srv1.sexydomain.com srv1
- If you suck at bash, use
nano /etc/hoststo make the changes. For reference, ^ means Ctrl, so ^Q means Ctrl+Q.
- If you suck at bash, use
- We need to set the mailname to be the same as the hostname. So type:
cp /etc/hostname /etc/mailname
- Restart your server (you can generally type
- You will notice that the bash prompt should now look different (something like srv1:~#).
- To ensure the server works. The following commands should show the following:
hostname -s: SHORTNAME (srv1)
hostname -f: FQDN (srv1.sexydomain.com)
hostname -d: DOMAIN (Sexydomain.com)
- If they don't match, you possibly missed a step or other mistakes were made.
Please refer to the Download page.
We recommend grabbing binaries if at all possible. If you need to build specific parts (or all of OpenPanel, of course), from source, use apt-get source to grab source packages, or clone from hg. Then use
Currently OpenPanel does not yet offer a built-in backup function. In order to be able to restore your system, it is recommended to backup your system just as you would backup it as if OpenPanel would not run on it. As far as OpenPanel is concerned you need at least:
/home/openpanel-admin /etc /var/openpanel/db
Also, do not forget to backup your mysql data. This is sometimes done by including /var/lib/mysql in the backup. Another way is to use a small script such as Automysqlbackup to do that for you. Also, people's home dirs do not automatically backup, so include /home if you want them to return after any recovery.
A word about restore
The OpenPanel data resides in two sqlite db files in /var/openpanel/db. In theory, if you put those two files back, and all the unix users, you can recreate all the objects in OpenPanel by updating them in the gui or cli without changing them.