Skip to main content

Install Paperless-ngx on Debian 12 (Using Official Script)

Paperless-ngx is a document management system for indexing, OCRing, and organizing scanned documents and PDFs. This guide walks you through setting it up on Debian 12 using the official installation script via Docker Compose.

Paperless provides an interactive installation script to set up a Docker Compose installation. The script asks for a couple of configuration options and will then create the necessary configuration files, pull the Docker image, start Paperless-ngx, and create your superuser account. 

🐳 1. Install Docker & Compose (Debian12)

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg lsb-release
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  
sudo apt-get update

# Install Docker $ Compose plugin
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

#Enable and Start Docker
sudo systemctl enable --now docker
sudo service docker start

📦 2. Run the Official Installation Script

Download and run the setup script:

bash -c "$(curl --location --silent --show-error https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)"
Follow the prompts.

🌐 4. Access the Interface

Once complete, go to:

http://<your-server-ip>:8000

📚 Reference

Back to top