Changing Host Systems

There are several options for moving a Xylok installation from on host machine to another, including:

Exporting and restoring the entire client archive from the Client page
Performing a database backup and restore, see Backups
Copying the raw database data and configuration to the new system

The final approach will result in an identical installation on the new system, including any current backups and system settings. The instructions below cover this third process.

The commands shown are intended to be robust to copy/pasting directly into the command line or as part of a script. “New” refers to the host Xylok is being installed onto, “existing” is the host with the current Xylok installation.

On the existing installation, update to the same version of Xylok as you will be installing on the new system (if possible).

On the existing installation, run these commands as root:

# Stop Xylok
systemctl stop xylok
# Back up all current data
currdir="$(pwd)"
cd "$(mktemp -d)"
cp -r /var/lib/xylok db/
cp /etc/xylok.conf .
cp -r /opt/xylok/ opt/
tar -cvzf "$currdir/xylok-complete.tar.gz" *
cd "$currdir"
ls -lh xylok-complete.tar.gz

Copy the xylok-complete.tar.gz file from the existing system to the new system.
On the new system install Xylok as a “new” installation. At the end ignore the prompt to create an initial superuser—this information will be blown away when the backup is restored.

On the new system run these commands as root, with the backup tar file in the current directory:

# Stop Xylok
systemctl stop xylok
# Extract the tar file
currdir="$(pwd)"
cd "$(mktemp -d)"
cp "$currdir/xylok-complete.tar.gz" .
tar xaf *.gz
# Restore data. Unalias is to get rid of the copy prompt
# Note the "." in the cp commands
unalias cp
cp xylok.conf /etc/xylok.conf
cp -r opt/. /opt/xylok/
cp -r db/. /var/lib/xylok/
cd "$currdir"
# Restart Xylok
systemctl start xylok
# Ensure database is migrated
/opt/xylok/run-management-cmd.sh migrate

On the new system, access Xylok via the web browser and ensure everything is correct. Xylok may take a minute to fully start, so if you encounter a “not found” error initially try again after a few seconds.

If you encounter an issue with this process, feel free to contact support@xylok.io for additional help.