How to Install Mayan EDMS on Linux Mint

Mayan EDMS is an open-source document management system that helps you to store and manage your electronic documents. In this tutorial, we will show you how to install Mayan EDMS on Linux Mint.

Prerequisites

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

Step 1: Update System Packages

Before installing any new software, it's always a good practice to update your system packages. To update, open the terminal and execute the following command:

sudo apt update && sudo apt upgrade

Step 2: Install Required Dependencies

Mayan EDMS requires some dependencies, including PostgreSQL, Python 3, and some additional Python modules. You can install these dependencies by running the following command:

sudo apt install postgresql python3 python3-pip python3-setuptools python3-dev libpq-dev libmagic-dev libffi-dev libssl-dev redis

Step 3: Install Mayan EDMS

The best way to install the Mayan EDMS is by using the pip package manager. First, you need to install pip on your system. To install pip, execute the following command:

sudo apt install python3-pip

After installing pip, you can install Mayan EDMS by running the following command:

sudo pip3 install mayan-edms

Step 4: Configure PostgreSQL

Mayan EDMS uses PostgreSQL as the backend database. Next, we need to create a new PostgreSQL database and user for Mayan EDMS. To do this, execute the following commands:

sudo su postgres
createuser --createdb --username postgres mayan
createdb --owner mayan mayan
exit

Step 5: Create Mayan EDMS Configuration

Next, you need to create a new Mayan EDMS configuration file. To do this, execute the following command:

sudo nano /etc/mayan-edms.conf

Add the following lines to the file:

[database]
ENGINE=django.db.backends.postgresql_psycopg2
NAME=mayan
USER=mayan
PASSWORD=<your_password>
HOST=127.0.0.1
PORT=5432

[storage]
STORAGE_BACKEND=django.core.files.storage.FileSystemStorage
STORAGE_BACKEND_ARGUMENTS='{"location": "/opt/mayan-edms/media/"}'

[redis]
BROKER_URL=redis://127.0.0.1:6379/0
CELERY_RESULT_BACKEND=redis://127.0.0.1:6379/0

Replace <your_password> with a strong password.

Step 6: Initialize Mayan EDMS

Before starting Mayan EDMS, we need to initialize the database schema and create a superuser account. To do this, execute the following command:

sudo mayan-edms.py initialsetup

When prompted, create a superuser account by entering a username, email, and password.

Step 7: Start Mayan EDMS

After initializing the setup, start the Mayan EDMS service by running the following command:

sudo systemctl start mayan-edms

To stop and restart the service, use the following commands:

sudo systemctl stop mayan-edms
sudo systemctl restart mayan-edms

Conclusion

Congratulations! You have successfully installed Mayan EDMS on Linux Mint. Now, you can use Mayan EDMS to manage and store your electronic documents.

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!