Mayan EDMS is an open-source document management system that provides an easy way to automate document workflows, archival, and retrieval. In this tutorial, we will show you how to install Mayan EDMS on an Ubuntu Server.
Before proceeding with the installation, make sure you have the following:
First, we need to update the package list and install some necessary packages. Run the following commands:
sudo apt update
sudo apt install -y build-essential libjpeg-dev libxml2-dev libxslt1-dev zlib1g-dev git python3-dev python3-pip python3-venv
We will create a Python virtual environment for Mayan EDMS to avoid system-wide installation of packages. Run the following commands:
sudo mkdir /opt/mayan-edms
sudo chown -R $USER:$USER /opt/mayan-edms
cd /opt/mayan-edms
python3 -m venv venv
source venv/bin/activate
With the virtual environment active, we can install Mayan EDMS using pip. Run the following commands:
pip install --upgrade pip wheel
pip install mayan-edms
Now that we have Mayan EDMS installed, we need to configure it. Run the following command to generate the initial settings:
mayan-edms.py initialsetup
Follow the prompts to set up the administrator account, database settings, and other required settings.
To start Mayan EDMS, run the following command:
mayan-edms.py runserver
You should now be able to access Mayan EDMS by navigating to http://your-server-ip:8000 in your web browser.
If you want to serve Mayan EDMS from Nginx, create a new configuration file:
sudo nano /etc/nginx/sites-available/mayan-edms
And paste the following configuration:
server {
listen 80;
server_name your-server-ip;
location / {
proxy_pass http://localhost:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
Enable the site and restart Nginx:
sudo ln -s /etc/nginx/sites-available/mayan-edms /etc/nginx/sites-enabled/mayan-edms
sudo service nginx restart
You should now be able to access Mayan EDMS from your web browser by navigating to http://your-server-ip.
Congratulations! You have successfully installed and configured Mayan EDMS on your Ubuntu Server.
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!
