Skip to content

paperless

Example

nix
{config, ...}: {
  paperless = {
    enable = true;

    adminProvisioning = {
      username = "admin";
      passwordFile = config.sops.secrets."paperless/admin_password".path;
      email = "admin@example.com";
    };
    secretKeyFile = config.sops.secrets."paperless/secret_key".path;
    db.passwordFile = config.sops.secrets."paperless/db_password".path;
    extraEnv = {
      PAPERLESS_OCR_LANGUAGES = "eng deu";
      PAPERLESS_OCR_LANGUAGE = "eng+deu";
    };

    oidc = {
      enable = true;
      clientSecretFile = config.sops.secrets."paperless/authelia_client_secret".path;
      clientSecretHash = "$pbkdf2-sha512$...";
    };
  };
}

Stack Options

nps.stacks.paperless.adminProvisioning.email

Email address for the admin user

Type
plaintext
string
Declaration

nps.stacks.paperless.adminProvisioning.enable

Whether to automatically create an admin user on the first run. If set to false, an admin user can be manually created using the createsuperuser command.

See https://docs.paperless-ngx.com/administration/#create-superuser

Type
plaintext
boolean
Default
nix
true
Declaration

nps.stacks.paperless.adminProvisioning.passwordFile

Path to a file containing the admin user password

Type
plaintext
absolute path
Default
nix
null
Declaration

nps.stacks.paperless.adminProvisioning.username

Username for the admin user

Type
plaintext
string
Default
nix
"admin"
Declaration

nps.stacks.paperless.containers.paperless

Alias of {option}services.podman.containers.paperless.

Type
plaintext
submodule
Declaration

nps.stacks.paperless.containers.paperless-broker

Alias of {option}services.podman.containers.paperless-broker.

Type
plaintext
submodule
Declaration

nps.stacks.paperless.containers.paperless-db

Alias of {option}services.podman.containers.paperless-db.

Type
plaintext
submodule
Declaration

nps.stacks.paperless.containers.paperless-ftp

Alias of {option}services.podman.containers.paperless-ftp.

Type
plaintext
submodule
Declaration

nps.stacks.paperless.db.passwordFile

Path to the file containing the database password for Paperless

Type
plaintext
absolute path
Declaration

nps.stacks.paperless.db.username

Database user name for Paperless

Type
plaintext
string
Default
nix
"paperless"
Declaration

nps.stacks.paperless.enable

Whether to enable paperless.

Type
plaintext
boolean
Default
nix
false
Example
nix
true
Declaration

nps.stacks.paperless.extraEnv

Extra environment variables to set for the container. Variables can be either set directly or sourced from a file (e.g. for secrets).

See https://docs.paperless-ngx.com/configuration

Type
plaintext
attribute set of (null or boolean or signed integer or string or absolute path or (submodule))
Default
nix
{ }
Declaration

nps.stacks.paperless.ftp.enable

Whether to enable FTP server.

Type
plaintext
boolean
Default
nix
false
Example
nix
true
Declaration

nps.stacks.paperless.ftp.passwordFile

Path to the file containing the FTP password

Type
plaintext
absolute path
Declaration

nps.stacks.paperless.oidc.clientSecretFile

The file containing the client secret for the Paperless OIDC client that will be registered in Authelia.

Type
plaintext
string
Declaration

nps.stacks.paperless.oidc.clientSecretHash

The hashed client_secret. For examples on how to generate a client secret, see

https://www.authelia.com/integration/openid-connect/frequently-asked-questions/#client-secret

Type
plaintext
string
Declaration

nps.stacks.paperless.oidc.enable

Whether to enable OIDC login with Authelia. This will register an OIDC client in Authelia and setup the necessary configuration for Paperless.

For details, see:

For details, see:

Type
plaintext
boolean
Default
nix
false
Declaration

nps.stacks.paperless.oidc.userGroup

Users of this group will be able to log in

Type
plaintext
string
Default
nix
"paperless_user"
Declaration

nps.stacks.paperless.secretKeyFile

Path to the file containing the Paperless secret key

See https://docs.paperless-ngx.com/configuration/#PAPERLESS_SECRET_KEY

Type
plaintext
absolute path
Declaration