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.
Changing the default host name after installation
Changing the host name (when already changed from the default)
newhost='server.example.com' oldhost=$(hostname -f)
Update the files
Now you should be able to copy and paste the following into your SSH session:
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.
Whilst /etc/hosts does not match the server's new hostname various services will fail to start and your websites will not be available. Also /etc/hosts may not stick after a reboot. For example on a Brightbox server the hosts file is recreated from a template each time (as documented in the hosts file) so make sure you edit the template to make the new host name stick.
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.