How to Install Papermerge on Linux Mint

Papermerge is an open-source document management system that helps organizations organize their digital documents efficiently. In this tutorial, we will show you how to install Papermerge on Linux Mint.

Prerequisites

Before proceeding with the installation, make sure you have the following prerequisites:

• A Linux Mint system with sudo privileges
• Python 3.x installed
• PostgreSQL or SQLite database

Step 1: Install Dependencies

Firstly, update the package list and install the necessary dependencies.

sudo apt update
sudo apt install -y python3-pip python3-venv postgresql libpq-dev build-essential git

Step 2: Create a Virtual Environment

Create a virtual environment for Papermerge using the below command.

python3 -m venv env

Activate the virtual environment using the following command.

source env/bin/activate

Step 3: Download and Install Papermerge

Download Papermerge from their official website using the below command or clone their repository using git.

wget https://files.papermerge.com/releases/latest/papermerge-x.y.z.zip

Unzip the file and navigate to the papermerge directory.

unzip papermerge-x.y.z.zip && cd papermerge-x.y.z

Once you are in the papermerge directory, run the following command to install the required packages.

pip install .

Step 4: Configure the Settings

Copy the default settings file to a new file called settings.py.

cp papermerge/settings/local.py.example papermerge/settings/local.py

Change the database settings in the newly created settings file.

DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.postgresql",
        "NAME": "papermerge",
        "USER": "papermergeuser",
        "PASSWORD": "your_password_here",
        "HOST": "localhost",
        "PORT": "5432",
    }
}

Note: Change the USER and PASSWORD values with your own PostgreSQL user and password.

Step 5: Create and Migrate the Database

Create a new PostgreSQL database, user, and password.

sudo -u postgres psql
CREATE DATABASE papermerge;
CREATE USER papermergeuser WITH PASSWORD 'your_password_here';
GRANT ALL PRIVILEGES ON DATABASE papermerge TO papermergeuser;

Migrate the database to apply the initial schema.

python manage.py migrate

Create a superuser account to manage the Papermerge.

python manage.py createsuperuser

Step 6: Run the Server

Finally, start the Papermerge server using the following command.

python manage.py runserver 0.0.0.0:8000

Access the Papermerge web interface on your Linux Mint system using http://localhost:8000.

Conclusion

Congratulations! You have successfully installed and configured Papermerge on your Linux Mint system. You can now start using Papermerge to manage your digital documents.