Changing Your Server Hostname
A number of functions in Sympl use the servers hostname to determine its defaults, such as emails sent to unix users, the default fallback site for any unmatched sites, and the default SSL certificates used for things like Email and FTP connections.
This means that properly changing the server hostname can be tricky, and missing one or more elements can cause unexpected problems later on.
Functionality for automatically changing the hostname will be included in Sympl at a future date, however you may follow the instructions below to change the hostname manually via SSH.
Set the new hostname
To avoid typing it multiple times, you should set the new hostname as a variable. This can be the URL for a domain it’s already hosting, or just the name of the server from your hosting provider, however the domain must point to the server already, and should have at least one dot (ie: '
.') in it.
Update the files
Now you should be able to copy and paste the following into your SSH session:
oldhost=$(hostname -f) sudo hostname $newhost
You may be prompted for the
sympl user password. Enter it if so.
if [ ! -d /srv/$newhost/ ]; then mv /srv/$oldhost/ /srv/$newhost/; fi
You may want to change the SSL provider for the new hostname before continuing (e.g.
letsencrypt). See SSL Configuration Reference
sudo sympl-ssl --verbose --force $newhost sudo rm /etc/ssl/ssl.combined /etc/ssl/ssl.crt /etc/ssl/ssl.key sudo ln -s /srv/$newhost/config/ssl/current/ssl.combined /etc/ssl/ssl.combined sudo ln -s /srv/$newhost/config/ssl/current/ssl.crt /etc/ssl/ssl.crt sudo ln -s /srv/$newhost/config/ssl/current/ssl.key /etc/ssl/ssl.key sudo sympl-web-configure echo $newhost | sudo tee /etc/hostname | sudo tee /etc/mailname
You will need to update the servers hosts file,
/etc/hosts, with the new name of the server.
In your text editor of choice, such as
vim, edit the
/etc/hosts file, and replace each instance of the old name for the server with the new name. You may have entries which are the 'short' hostname (the first part of the hostname, such as '
server' in the above example), so remember to change them to the short name also.
Finally, to ensure everything is updated fully and the new hostname is consistent, reboot the server. Once it's rebooted everything should have been updated fully.