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:

  1. Stop all ahriman services.

  2. Remove the old generated configuration files. For example, for repository aur and architecture x86_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.

  3. Run setup command (i.e. ahriman service-setup) again with the same arguments as used before as the ahriman user.

  4. 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.

  1. Stop all containers using the repository volume and create a backup.

  2. Run a one-off container which mounts the existing volume. Replace VOLUME with 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'
    
  3. Update custom configuration and container arguments which refer to /var/lib/ahriman/ahriman. The new path is /var/lib/ahriman.

  4. 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.