Updating your instance¶
You should always check the release notes/changelog in case there are config deprecations, special update steps, etc.
Besides that, doing the following is generally enough:
For OTP installations¶
# Download the new release
su akkoma -s $SHELL -lc "./bin/pleroma_ctl update --branch develop"
# Migrate the database, you are advised to stop the instance before doing that
su akkoma -s $SHELL -lc "./bin/pleroma_ctl migrate"
For from source installations (using git)¶
- Go to the working directory of Akkoma (default is
/opt/akkoma
) - Run
git pull
[^1]. This pulls the latest changes from upstream. - Run
mix deps.get
[^1]. This pulls in any new dependencies. - Stop the Akkoma service.
- Run
mix ecto.migrate
[^1] [^2]. This task performs database migrations, if there were any. - Start the Akkoma service.
[^1]: Depending on which install guide you followed (for example on Debian/Ubuntu), you want to run git
and mix
tasks as akkoma
user by adding sudo -Hu akkoma
before the command.
[^2]: Prefix with MIX_ENV=prod
to run it using the production config file.