How to Install Mayan EDMS on macOS

Mayan EDMS is an open-source document management system that allows easy management, organization, and sharing of electronic documents. In this tutorial, we will guide you step by step on how to install Mayan EDMS on macOS.

Prerequisites

Before installing Mayan EDMS, make sure you have the following prerequisites:

  • macOS installed on your system
  • Python 3.7 or later installed
  • PostgreSQL 9.6 or later installed

Step 1: Install Homebrew

Homebrew is a package manager for macOS that makes it easy to install and manage applications. If you don't have Homebrew installed already, you can install it by following these steps:

  1. Open the Terminal app on your macOS system.
  2. Enter the following command to download and install Homebrew:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. Wait for the installation to complete.

Step 2: Install Mayan EDMS Dependencies

Mayan EDMS requires certain dependencies to be installed on your system. You can install these dependencies by following these steps:

  1. Open the Terminal app on your macOS system.
  2. Enter the following command to install the dependencies:
brew install librsvg ghostscript sane-backends tesseract poppler imagemagick postgresql libmagic redis
  1. Wait for the installation to complete.

Step 3: Install Mayan EDMS

You can now install Mayan EDMS by following these steps:

  1. Open the Terminal app on your macOS system.
  2. Enter the following command to install Mayan EDMS:
pip3 install mayan-edms
  1. Wait for the installation to complete.

Step 4: Configure PostgreSQL

You need to create a new PostgreSQL database for Mayan EDMS. You can do this by following these steps:

  1. Open the Terminal app on your macOS system.
  2. Enter the following command to log in to PostgreSQL:
psql -U postgres
  1. Enter your PostgreSQL password to log in.
  2. Enter the following command to create a new database for Mayan EDMS:
CREATE DATABASE mayan;
  1. Enter the following command to create a new user for Mayan EDMS:
CREATE USER mayan WITH PASSWORD 'mayan_password';
  1. Enter the following command to grant permissions to the Mayan EDMS user:
GRANT ALL PRIVILEGES ON DATABASE mayan TO mayan;
  1. Enter the following command to quit PostgreSQL:
\q

Step 5: Configure Mayan EDMS

You can now configure Mayan EDMS by following these steps:

  1. Open the Terminal app on your macOS system.
  2. Enter the following command to create a new Mayan EDMS configuration file:
mayan-edms.py initialsetup
  1. Follow the on-screen prompts to configure Mayan EDMS.
  2. Enter your PostgreSQL database details when prompted.

Step 6: Run Mayan EDMS

You can now run Mayan EDMS by following these steps:

  1. Open the Terminal app on your macOS system.
  2. Enter the following command to start the Mayan EDMS server:
mayan-edms.py runserver
  1. Open a web browser and navigate to http://localhost:8000.
  2. Log in with the username and password you created during Step 5.

Congratulations! You have successfully installed and configured Mayan EDMS on your macOS system. You can now start managing, organizing, and sharing your electronic documents with ease.