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
-
Read the release notes
Some versions require a specific action. See the release notes.
-
Back up
See Backup and restore.
-
Install the new version
Terminaldocker compose pull docker compose up -dTerminalsudo apt install ./lore_0.1.1_amd64.debTerminalsudo dnf install ./lore-0.1.1-1.x86_64.rpmTerminaltar xzf lore-0.1.1.tar.gz cp lore-0.1.0/conf/lore.env lore-0.1.1/conf/ # Stop the older version, then: lore-0.1.1/bin/loreThe package restarts the service itself if it was running. Your settings, in
/etc/lore/lore.env, are kept.With Docker Compose,
docker compose pullinstalls the latest patch release of the tag written indocker-compose.yml, for example0.1. To move to the next release, first replace this tag, for example with0.2, or download thedocker-compose.ymlfile of the new release. -
Check
Terminaldocker compose logs -f loreTerminalsudo journalctl -u lore -f
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 |