Skip to content

Offline mode

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
    sudo -E docker load -i /tmp/tuoni-transfer/tuoni-docker-images.tar
    
  • Update the version
    TUONI_VERSION=$(cat $PROJECT_ROOT/version.yml | cut -d ' ' -f 2)
    sed -i "s/VERSION=.*/VERSION=${TUONI_VERSION}/g" "$PROJECT_ROOT/config/tuoni.env"