How to Install Mayan EDMS on POP! OS Latest

Mayan EDMS is a free and open-source document management system that allows you to store, share, and manage documents, files, and images. In this tutorial, we will show you how to install Mayan EDMS on POP! OS Latest.

Prerequisites

Before starting, make sure you have the following requirements:

Step 1: Update the System

The first step is to update the system to the latest version. Open the terminal by pressing Ctrl + Alt + T or search terminal in the applications menu. Then run the following command:

sudo apt update && sudo apt upgrade -y

It will take a few minutes to complete depending on your internet speed.

Step 2: Install Required Packages

Mayan EDMS requires the following packages to be installed on the system:

You can install them by running the following command:

sudo apt install python3 python3-pip postgresql postgresql-contrib redis-server rabbitmq-server -y

Step 3: Install Mayan EDMS

Once you have installed the required packages, the next step is to install Mayan EDMS. You can install Mayan EDMS using pip. Run the following command:

sudo pip3 install mayan-edms

It will take a few minutes to complete depending on your internet speed.

Step 4: Configure PostgreSQL

Mayan EDMS requires a database to store its data. In this tutorial, we will configure PostgreSQL as a database server for Mayan EDMS.

4.1 Create a PostgreSQL User and Database for Mayan EDMS

First, log in as the PostgreSQL user and create a new user and database for Mayan EDMS.

sudo su postgres
createuser mayan -P
createdb mayan -O mayan
exit

4.2 Configure PostgreSQL Settings

Next, edit the pg_hba.conf file to allow the Mayan EDMS user to access the database.

sudo nano /etc/postgresql/<version>/main/pg_hba.conf

Replace <version> with your PostgreSQL version, for example, sudo nano /etc/postgresql/12/main/pg_hba.conf

Add the following line at the end of the file:

host   mayan    mayan    127.0.0.1/32  md5

Save and close the file by pressing Ctrl + X, followed by Y and then enter.

Then, edit the postgresql.conf file and set the listen_addresses to '*':

sudo nano /etc/postgresql/<version>/main/postgresql.conf

Replace <version> with your PostgreSQL version, for example, sudo nano /etc/postgresql/12/main/postgresql.conf

Find the line #listen_addresses = 'localhost' and uncomment it by removing the # symbol at the start of the line. Then, change the value to '*' as follows:

listen_addresses = '*'

Save and close the file by pressing Ctrl + X, followed by Y and then enter.

Finally, restart PostgreSQL service to apply the changes:

sudo systemctl restart postgresql

Step 5: Configure Mayan EDMS

Now, we need to configure Mayan EDMS to use the PostgreSQL database we created earlier.

5.1 Configure Redis

Mayan EDMS requires a Redis server to use as a message broker. By default, Redis is already installed on your system.

You can verify the Redis status by running:

sudo systemctl status redis

If it is not running, start it using the following command:

sudo systemctl start redis

Then, enable Redis to start at system boot:

sudo systemctl enable redis

5.2 Configure RabbitMQ

Mayan EDMS also requires a RabbitMQ server to use as a message broker. You can install RabbitMQ using the following command:

sudo apt install rabbitmq-server -y

Then, start and enable the RabbitMQ service:

sudo systemctl start rabbitmq-server
sudo systemctl enable rabbitmq-server

5.3 Run the Mayan EDMS Initial Configuration Wizard

To configure Mayan EDMS, you need to run the initial configuration wizard. Run the following command to start the configuration wizard:

mayan-edms.py initialsetup

Follow the instructions and enter the information as required:

Once you have completed the configuration wizard, you can start the Mayan EDMS service:

mayan-edms.py runserver

Step 6: Access Mayan EDMS

Mayan EDMS should now be accessible via a web browser. Open your web browser and navigate to http://localhost:8000. You should see the Mayan EDMS login page.

Login using the username admin and the password you set in the initial configuration wizard.

Congratulations! You have successfully installed Mayan EDMS on your POP! OS Latest system.

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!