# Paperless-ngx Installation 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 Paperless-ngx 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)"
```

<div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary" id="bkmrk-follow-the-prompts."><div class="overflow-y-auto p-4" dir="ltr">Follow the prompts.</div></div>#### 🌐 4. Access the Interface

Once complete, go to:

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

#### 📚 Reference

- 📄 Official GitHub Repository:  
    [https://github.com/paperless-ngx/paperless-ngx](https://github.com/paperless-ngx/paperless-ngx)
- 📘 Docker Installation Guide:  
    [https://docs.docker.com/engine/install/debian/](https://docs.docker.com/engine/install/debian/)
- 📖 Paperless-ngx Documentation:  
    [https://docs.paperless-ngx.com/](https://docs.paperless-ngx.com/)