Jump to content

Pixelfed

From Official NixOS Wiki
Revision as of 21:31, 7 August 2026 by Onny (talk | contribs) (Add instructions on how to add inital admin account)

Pixelfed is a free and ethical photo sharing platform, powered by ActivityPub federation.

Setup

A minimal setup of Pixelfed can be enabled using following example.

environment.etc."pixelfed-secret.env".text = "APP_KEY=adKK9EcY8Hcj3PLU7rzG9rJ6KKTOtYfA";

services.pixelfed = {
  enable = true;
  domain = "pics.example.org";
  nginx = {
    enableACME = true;
    forceSSL = true;
  };
  secretFile = "/etc/pixelfed-secret.env";
};

Reference Nginx page for instructions on how to configure SSL and ACME. To create an administrator account that can also be used to log into Pixelfed, run the following commands.

pixelfed-manage user:create --name=test --username=test --email=test@test.com --password=test
pixelfed-manage user:admin test