PdfDing

PdfDing

Docker app from grtgbln's Repository

Overview

Self-hosted PDF manager, viewer and editor offering a seamless user experience on multiple devices.

Requirements


        Optionally can use a separate Postgres database container, or a built-in SQLite database.
    

Runtime arguments

Web UI
http://[IP]:[PORT:8000]/
Network
bridge
Privileged
false

Template configuration

Web UI PortPorttcp

Container Port: 8000

Target
8000
Default
8000
Value
8000
Media PathPath

Path to the media folder

Target
/home/nonroot/pdfding/media
ThemeVariable

Theme

Target
DEFAULT_THEME
Default
dark|light
Theme ColorVariable

Theme color

Target
DEFAULT_THEME_COLOR
Default
green|blue|red|pink|orange|gray
Secret KeyVariable

Used for securing signed data. Should be to a large random value.

Target
SECRET_KEY
Host NameVariable

The host/domain name where PdfDing will be reachable.

Target
HOST_NAME
Default
127.0.0.1
Value
127.0.0.1
Require User Email VerificationVariable

Block users until they have verified their email address.

Target
ACCOUNT_EMAIL_VERIFICATION
Default
TRUE|FALSE
Disable User SignupsVariable

Disable user signups

Target
DISABLE_USER_SIGNUPS
Default
FALSE|TRUE
Database - TypeVariable

Database type

Target
DATABASE_TYPE
Default
SQLITE|POSTGRES
Database - HostVariable

Postgres database host. Remove if using SQLite.

Target
POSTGRES_HOST
Database - PortVariable

Postgres database port. Remove if using SQLite.

Target
POSTGRES_PORT
Default
5432
Database - PasswordVariable

Postgres database password. Remove if using SQLite.

Target
POSTGRES_PASSWORD
OIDC - EnableVariable

Enable OpenID Connect

Target
OIDC_ENABLE
Default
FALSE|TRUE
OIDC - Provider NameVariable

OpenID Connect provider name

Target
OIDC_PROVIDER_NAME
OIDC - Client IDVariable

OpenID Connect client ID

Target
OIDC_CLIENT_ID
OIDC - Client SecretVariable

OpenID Connect client secret

Target
OIDC_CLIENT_SECRET
OIDC - Auth URLVariable

OpenID Connect authorization URL

Target
OIDC_AUTH_URL
OIDC - EnforceVariable

Require users to use OIDC

Target
OIDC_ONLY
Default
FALSE|TRUE
Email - BackendVariable

Whether to send account related emails, e.g a password reset or account verification, to the console or via an SMTP server.

Target
EMAIL_BACKEND
Default
CONSOLE|SMTP
Email - SMTP HostVariable

SMTP server host. Remove if using the console backend.

Target
SMTP_HOST
Email - SMTP PortVariable

SMTP server port. Remove if using the console backend.

Target
SMTP_PORT
Default
25
Email - SMTP UserVariable

SMTP server user. Remove if using the console backend.

Target
SMTP_USER
Email - SMTP PasswordVariable

SMTP server password. Remove if using the console backend.

Target
SMTP_PASSWORD
Email - SMTP TLSVariable

Secure the connection to the SMTP server with TLS. Remove if using the console backend.

Target
SMTP_USE_TLS
Default
FALSE|TRUE
Email - SMTP SSLVariable

Secure the connection to the SMTP server with SSL. Remove if using the console backend.

Target
SMTP_USE_SSL
Default
FALSE|TRUE
Consumption - EnableVariable

Enable the consumption folder as an alternative way for adding PDFs.

Target
CONSUME_ENABLE
Default
FALSE|TRUE
Consumption - Skip ExistingVariable

Skip the addition PDF files if the user already has PDF with the same name and file size.

Target
CONSUME_SKIP_EXISTING
Default
TRUE|FALSE
Consumption - TagsVariable

Comma separated list of tags to add to the PDFs added via the consumption folder.

Target
CONSUME_TAGS
Backups - EnableVariable

Enable periodic backups to S3 compatible storage.

Target
BACKUP_ENABLE
Default
FALSE|TRUE
Backups - S3 EndpointVariable

S3 compatible storage endpoint. Remove if not using backups.

Target
BACKUP_ENDPOINT
Backups - S3 Access KeyVariable

S3 compatible storage access key. Remove if not using backups.

Target
BACKUP_ACCESS_KEY
Backups - S3 Secret KeyVariable

S3 compatible storage secret key. Remove if not using backups.

Target
BACKUP_SECRET_KEY
Backups - S3 BucketVariable

S3 compatible storage bucket. Remove if not using backups.

Target
BACKUP_BUCKET_NAME
Backups - ScheduleVariable

Cron schedule for the backups. Default is midnight every day.

Target
BACKUP_SCHEDULE
Default
0 0 * * *
Backups - SecureVariable

Secure the connection to the S3 compatible storage with TLS.

Target
BACKUP_SECURE
Default
FALSE|TRUE
Backups - EncryptionVariable

Encrypt the backups before uploading them to the S3 compatible storage.

Target
BACKUP_ENCRYPTION_ENABLE
Default
FALSE|TRUE
Backups - Encryption PasswordVariable

Password to encrypt the backups. Remove if not using encryption.

Target
BACKUP_ENCRYPTION_PASSWORD
Backups - Encryption SaltVariable

Salt to encrypt the backups. Remove if not using encryption.

Target
BACKUP_ENCRYPTION_SALT
Database PathPathrw

Path to the SQLite database folder. Remove if using Postgres. May need to update write permissions.

Target
/home/nonroot/pdfding/db
Default
/mnt/user/appdata/pdfding/db
Value
/mnt/user/appdata/pdfding/db
PGIDVariable
Default
1000
Value
1000
PUIDVariable
Default
1000
Value
1000
Log LevelVariable

Log level

Target
LOG_LEVEL
Default
ERROR|WARN|INFO|DEBUG
Secure CSRF CookieVariable

Set this to TRUE to avoid transmitting the CSRF cookie over HTTP accidentally.

Target
CSRF_COOKIE_SECURE
Default
TRUE|FALSE
Secure Session CookieVariable

Set this to TRUE to avoid transmitting the session cookie over HTTP accidentally.

Target
SESSION_COOKIE_SECURE
Default
TRUE|FALSE
Secure SSL RedirectsVariable

Redirects all non-HTTPS requests to HTTPS. If PdfDing is running behind a reverse proxy this can cause infinite redirects.

Target
SECURE_SSL_REDIRECT
Default
FALSE|TRUE
Secure HSTS SecondsVariable

See details: https://github.com/mrmn2/PdfDing/blob/master/docs/configuration.md#secure_hsts_seconds

Target
SECURE_HSTS_SECONDS
Default Protocol for AccountVariable

The default protocol for account related URLs, e.g. for the password forgotten procedure.

Target
ACCOUNT_DEFAULT_HTTP_PROTOCOL
Default
https|http
Internal Server PortVariable

The port where the internal server is reachable. Not recommended to change.

Target
HOST_PORT
Default
8000
Value
8000

Download Statistics

274,793
Total Downloads
20,568
This Month
21,115
Avg / Month

Total Downloads Over Time

Loading chart...

Details

Repository
mrmn/pdfding:latest
Last Updated2026-04-12
First Seen2025-01-04

Run PdfDing on Unraid.

PdfDing is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.