Pleroma on NixOS: OTP Release

Quick Start

Add your pleroma configuration to /etc/pleroma/config.exs, make sure it's readable by the pleroma user.

You can then use the following example to get started.

Pleroma Configuration Management

Pleroma is expecting its configuration to be found at /etc/pleroma/config.exs. This configuration file is containing some secrets, making impossible for it to live in the Nix store.

You'll have to create this file manually. Two options:

1. You are migrating a src-based install (mix-based). You can re-use your $src_root/config/prod.secret.exs file. Change the use Mix.Config statement with use Config.
2. This is a new installation. In that case you can use pleroma_ctl instance gen --output config.exs --output-psql setup.psql, this will prompt you some questions and will generate both your config file and database initial migration. Note: pleroma_ctl will be in your system path as soon as you enable the pleroma service. You can alternatively build it by building this repo's default.nix derivation.

Pleroma Database Init

If it's not already done, you need to seed your pleroma postgresql database.

If you created your brand new pleroma configuration with pleroma_ctl instance gen --output-psql seed.psql, you can load the seed.psql dump to the database with sudo -u pleroma psql -f seed.psql.

Update Pleroma to a New Version

We're retrieving the binary distribution directly from the GitLab CI pipeline.

To find the latest and greatest bindist stable URL, you have to visit https://git.pleroma.social/pleroma/pleroma/-/tree/stable, clicky click on the CI status and find the amd64 release link.