Skip to content

Offline Mode

Prerequisites

To use Offline Mode, ensure the following are installed on your system:

Updating Tuoni in an air-gapped environment

In an updated Tuoni instance, run the command tuoni export-tuoni-package, which exports git and docker images to the /srv/tuoni/transfer folder.

SSH available:

You can use the tuoni transfer-tuoni-package command locally, which will rsync the local /srv/tuoni/transfer folder to the remote host's same location. After that, run tuoni import-tuoni-package on the remote host, which updates the git project and docker images from the transfer folder.

Rsync needs the following defined in /srv/tuoni/config/tuoni.env:

  • TRANSFER_REMOTE_USER=your-remote-host-username
  • TRANSFER_REMOTE_HOST=your-remote-host-ip-address

The rsync is done with /srv/tuoni/scripts/transfer.sh. If it does not meet your requirements, you can create your own transfer script at /srv/tuoni/scripts/transfer-custom.sh, and the new script will be automatically used instead of the default one.

No SSH available

Deliver the /srv/tuoni/transfer folder to the remote host's same location and run tuoni import-tuoni-package on the remote host.

Older version migration

When the existing remote Tuoni instance does not yet have the tuoni import-tuoni-package command, try the following steps on the remote host:

  • Deliver the local /srv/tuoni/transfer folder to the remote host's /tmp/tuoni-transfer
  • Set the git remote to that tmp folder:
1
2
3
4
cd /srv/tuoni
git remote add transfer /tmp/tuoni-transfer/git
git fetch transfer
git pull transfer main
  • Import docker images
1
sudo -E docker load -i /tmp/tuoni-transfer/tuoni-docker-images.tar
  • Update the version
1
2
TUONI_VERSION=$(cat $PROJECT_ROOT/version.yml | cut -d ' ' -f 2)
sed -i "s/VERSION=.*/VERSION=${TUONI_VERSION}/g" "$PROJECT_ROOT/config/tuoni.env"