Skip to content
Lore
Lore
Install LoreOpen the demo

Upgrading

An upgrade means installing the new version and restarting. Database migrations are applied on startup.

Documentation for version 0.1, in preparation. Commands, variables and API endpoints are proposals: they may change before the release.

On this page

Upgrade

  1. Read the release notes

    Some versions require a specific action. See the release notes.

  2. Back up

    See Backup and restore.

  3. Install the new version

    Terminal
    docker compose pull
    docker compose up -d

    The package restarts the service itself if it was running. Your settings, in /etc/lore/lore.env, are kept.

    With Docker Compose, docker compose pull installs the latest patch release of the tag written in docker-compose.yml, for example 0.1. To move to the next release, first replace this tag, for example with 0.2, or download the docker-compose.yml file of the new release.

  4. Check

    Terminal
    docker compose logs -f lore

Roll back

Database migrations cannot be undone. To go back to a previous version, restore the backup made before the upgrade, then reinstall the older version: the older image, or the older package with sudo apt install --allow-downgrades or sudo dnf downgrade.

Files of each release

Each release is published on the repository’s releases page, with these files:

File Contents
lore-0.1.0.tar.gz, lore-0.1.0.zip The universal archive
lore_0.1.0_amd64.deb, lore_0.1.0_arm64.deb The packages for Ubuntu and Debian
lore-0.1.0-1.x86_64.rpm, lore-0.1.0-1.aarch64.rpm The packages for RHEL, Rocky Linux and AlmaLinux
docker-compose.yml The Docker Compose file, with the image of the release
SHA256SUMS The checksums, to verify with sha256sum --check --ignore-missing SHA256SUMS

Image tags

Tag Content
0.1 The latest patch release of 0.1, recommended
0.1.3 A specific release