To 2.22.0
This release stores newly generated configuration files in the repository root and changes the docker image to run as the ahriman user. Existing system-wide configuration files remain supported, so regular installations do not require manual intervention. Docker installations require data migration.
Regular installation
Newly generated ahriman and devtools configuration files are stored below /var/lib/ahriman/.config/ahriman instead of system-wide configuration directories. Existing configurations continue to work without any changes.
However, it is recommended to migrate to the new configuration schema by doing the following steps:
Stop all ahriman services.
Remove the old generated configuration files. For example, for repository
aurand architecturex86_64:sudo rm /etc/ahriman.ini.d/00-setup-overrides-x86_64-aur.ini sudo rm /usr/share/devtools/pacman.conf.d/aur-x86_64.conf
Repeat this step for every configured repository. Do not remove manually maintained configuration overrides.
Run setup command (i.e.
ahriman service-setup) again with the same arguments as used before as theahrimanuser.Start the services again.
Docker installation
The repository root inside the Docker image has changed from /var/lib/ahriman/ahriman to /var/lib/ahriman. Existing repository contents must therefore be moved one directory level up, and the volume must be owned by the ahriman user.
Stop all containers using the repository volume and create a backup.
Run a one-off container which mounts the existing volume. Replace
VOLUMEwith the named volume or bind mount used by the installation:docker run --rm --user root --entrypoint bash \ --volume VOLUME:/var/lib/ahriman \ arcan1s/ahriman:latest \ -c 'find /var/lib/ahriman/ahriman -mindepth 1 -maxdepth 1 -exec mv -t /var/lib/ahriman -- {} + && rmdir /var/lib/ahriman/ahriman && chown ahriman:ahriman /var/lib/ahriman'
Update custom configuration and container arguments which refer to
/var/lib/ahriman/ahriman. The new path is/var/lib/ahriman.Start the containers again.
Please note, that some environment variables - AHRIMAN_FORCE_ROOT and AHRIMAN_REPOSITORY_ROOT - have been also removed and not supported anymore. AHRIMAN_POSTSETUP_COMMAND and AHRIMAN_PRESETUP_COMMAND are now executed as non-root user.