How to Install Docmost using Docker on AlmaLinux 8

Docmost is an open-source collaborative wiki and documentation software. As an open-source alternative to Notion and Confluence, Docmost is ideal for managing wikis, knowledge bases, or extensive project documentation. It provides all the tools you need to create, collaborate, and share knowledge effortlessly. Docmost supports the creation of Spaces, which can be tailored to different teams, projects, or departments. Each Space has its own permissions, ensuring secure and organized collaboration. It is Designed with seamless real-time collaboration, and allows multiple users to work on the same page simultaneously without overwriting each other's contributions. Additionally, the rich text editor includes support for markdown shortcuts, making content creation intuitive and efficient."

This guide will walk you through the steps to install Docmost on AlmaLinux 8 using Docker.

Update Your System

Before starting the installation process, make sure your system is up to date. Open a terminal and run:

dnf update -y

Install Required Packages

Install necessary packages for setting up dependencies,

dnf install -y yum-utils

Install Docker

If Docker is not already installed on your system, you can set it up by adding the Docker repository key and repository using the following steps:

Setting up Docker's repository allows you to install Docker and related tools from Docker's official repositories. This includes adding the Docker GPG key and repository to your system,

mkdir -p /etc/pki/rpm-gpg
curl -fsSL -o /etc/pki/rpm-gpg/docker.asc
chmod a+r /etc/pki/rpm-gpg/docker.asc

dnf config-manager --add-repo=

dnf makecache

dnf install -y docker-ce docker-ce-cli docker-buildx-plugin docker-compose-plugin

Start and enable Docker service

systemctl start docker

systemctl enable docker

Verify Docker installation

docker --version


[root@vps ~]# docker --version
Docker version 26.1.3, build b72abbb

Prepare Docmost Configuration

Create a directory for Docmost and download its Docker Compose configuration file,

mkdir docmost
cd docmost
curl -O


[root@vps ~]# mkdir docmost
//[root@vps ~]# cd docmost
[root@vps docmost]# curl -O
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   833  100   833    0     0   3653      0 --:--:-- --:--:-- --:--:--  3653

Generate Secret Key

Generate a secret key using the below command,

openssl rand -hex 32


[root@vps docmost]# openssl rand -hex 32

Temporarily store this secret key on your local system using a text editor or any other method. We will use this key in the docker-compose.yml file

Now, open the docker-compose.yml file in a text editor. If you don't have a text editor installed, you can install Nano using the following command:

dnf install nano -y
nano docker-compose.yml

The downloaded docker-compose.yml file should include the following template with default environment variables:

version: "3"

    image: docmost/docmost:latest
      - db
      - redis
      APP_URL: "http://localhost:3000"
      DATABASE_URL: "postgresql://docmost:STRONG_DB_PASSWORD@db:5432/docmost?schema=public"
      REDIS_URL: "redis://redis:6379"
      - "3000:3000"
    restart: unless-stopped
      - docmost:/app/data/storage

    image: postgres:16-alpine
      POSTGRES_DB: docmost
      POSTGRES_USER: docmost
    restart: unless-stopped
      - db_data:/var/lib/postgresql/data

    image: redis:7.2-alpine
    restart: unless-stopped
      - redis_data:/data


Replace the default configurations with the following:

APP_URL: "http://Your_server_IP_address:3000"

APP_SECRET: "f73a69f2b9bbe568a5ec4df3a1e874eaf196ce2177d7ff446be6e53fcaed25c2"

DATABASE_URL: "postgresql://docmost:STRONG_DB_PASSWORD@db:5432/docmost?schema=public"


Note: Replace Your_server_IP_address with your actual server IP address or domain name

Note: Enter the key you generated earlier in app_secret:

Note: Replace Strong_DB_Password with your desired database password.

Save and exit the file.

Configure Firewall for Docmost

Check Firewall Status

systemctl status firewalld

Start and Enable the firewall if it's disabled.

systemctl start firewalld
systemctl enable firewalld

Need to allow incoming traffic on port 3000/tcp for Docmost using firewalld:

firewall-cmd --zone=public --add-port=3000/tcp --permanent

Reload the firewall,

firewall-cmd --reload

Check the firewall status using below command,

firewall-cmd --zone=public --list-ports

Start Docmost Containers

Launch Docmost containers using Docker Compose,

docker compose up -d

Verifying Docmost Installation

Once you have successfully set up and started the Docmost services, you can verify the installation by following these steps:

Open Your Web Browser and navigate to docmost, enter the following URL in your browser's address bar,


Note: Replace the localhost with your actual IP Address

Setup the Workspace Name, Admin Name, Email, Login Password and click on setup workspace,


Click on General to get the Docmost dashboard,


You'll see the Docmost dashboard like below,


That’s it! These steps cover verifying the successful installation and initial setup of Docmost on your AlmaLinux 8 server. Enjoy using Docmost for document management and collaboration.