How to Install Paperless-ngx on Windows 11

In this tutorial, we will guide you through the steps needed to install Paperless-ngx on Windows 11.

Step 1: Install Required Software

Before you can get started with installing Paperless-ngx, you will need to ensure that your Windows 11 machine has the following software installed:

Step 2: Download Paperless-ngx

  1. Open Git Bash on your Windows 11 machine.

  2. Navigate to the location where you want to download the Paperless-ngx repository.

  3. Run the following command to clone the repository:

    git clone https://github.com/jonaswinkler/paperless-ngx.git
    

Step 3: Create Virtual Environment

  1. Open Git Bash on your Windows 11 machine.

  2. Navigate to the Paperless-ngx directory that you downloaded in step 2.

  3. Run the following command to create a new virtual environment:

    python -m venv env
    
  4. Activate the virtual environment by running:

    source env/Scripts/activate
    

Step 4: Install Dependencies

  1. Once you have activated the virtual environment, run the following command to install the dependencies:

    pip install -r requirements.txt
    

Step 5: Set Up Database

  1. Open PostgreSQL and create a new database named paperless.

  2. Navigate to the Paperless-ngx directory in Git Bash.

  3. Run the following command to set up the database:

    python manage.py migrate
    

Step 6: Create Superuser

  1. Navigate to the Paperless-ngx directory in Git Bash.

  2. Run the following command to create a superuser account:

    python manage.py createsuperuser
    

    This will prompt you to set a username, email, and password.

Step 7: Start the Server

  1. Navigate to the Paperless-ngx directory in Git Bash.

  2. Run the following command to start the server:

    python manage.py runserver
    
  3. Open your web browser and go to http://127.0.0.1:8000/. You should see the Paperless-ngx login page.

  4. Log in with the superuser account that you created in Step 6.

Congratulations! You have successfully installed Paperless-ngx on Windows 11.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!