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.
Before starting, make sure you have the following requirements:
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.
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
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.
Mayan EDMS requires a database to store its data. In this tutorial, we will configure PostgreSQL as a database server 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
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
Now, we need to configure Mayan EDMS to use the PostgreSQL database we created earlier.
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
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
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:
PostgreSQL database enginedatabase name: mayandatabase user: mayandatabase password that you set earlierdatabase host: localhostOnce you have completed the configuration wizard, you can start the Mayan EDMS service:
mayan-edms.py runserver
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!
Alternatively, for the best virtual desktop, try Shells!
