How to Install Docmost using Docker on Ubuntu 25.04

Docmost is a Docker-based tool that facilitates collaborative documentation management, leveraging containers for scalability and ease of deployment. It aims to streamline workflow efficiency by providing a straightforward platform for creating and maintaining documentation within teams.

Update and Upgrade System

Ensure your system is up to date and upgraded to the latest packages,

apt update -y

apt upgrade -y

Install Required Packages

Install necessary packages for setting up dependencies,

apt-get update
apt-get install ca-certificates curl

Set Up Docker Repository Key and Repository

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,

install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null

Update apt and Install Docker

Updating apt and installing Docker and its dependencies from the Docker repository,

apt-get update

apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Output:

apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
Hit:1 http://nl.archive.ubuntu.com/ubuntu plucky InRelease
Hit:2 http://nl.archive.ubuntu.com/ubuntu plucky-updates InRelease
Hit:3 http://nl.archive.ubuntu.com/ubuntu plucky-backports InRelease
Hit:4 http://security.ubuntu.com/ubuntu plucky-security InRelease
Hit:5 https://download.docker.com/linux/ubuntu plucky InRelease
Reading package lists... Done
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
docker-ce is already the newest version (5:28.1.1-1~ubuntu.25.04~plucky).
docker-ce-cli is already the newest version (5:28.1.1-1~ubuntu.25.04~plucky).
containerd.io is already the newest version (1.7.27-1).
docker-buildx-plugin is already the newest version (0.23.0-1~ubuntu.25.04~plucky).
docker-compose-plugin is already the newest version (2.35.1-1~ubuntu.25.04~plucky).
Solving dependencies... Done

Verify Docker Installation

Run a Docker container to verify that Docker is installed and functioning correctly,

docker run hello-world

Output:

root@server:~# docker run hello-world
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
e6590344b1a5: Pull complete
Digest: sha256:c41088499908a59aae84b0a49c70e86f4731e588a737f1637e73c8c09d995654
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
    (amd64)
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
 $ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:
 https://hub.docker.com/

For more examples and ideas, visit:
 https://docs.docker.com/get-started/

Prepare Docmost Configuration

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

mkdir docmost
cd docmost
curl -O https://raw.githubusercontent.com/docmost/docmost/main/docker-compose.yml

Output:

root@server:~# mkdir docmost
root@server:~# mkdir docmost
mkdir: cannot create directory ‘docmost’: File exists
root@server:~# curl -O https://raw.githubusercontent.com/docmost/docmost/main/docker-compose.yml
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   833  100   833    0     0   3868      0 --:--:-- --:--:-- --:--:--  3892

Generate Secret Key

Generate a secret key using the below command,

openssl rand -hex 32

Output:

root@vps:~/docmost# openssl rand -hex 32
feae43defc091d1a4bad62290c0808eb47f5b5971952bdcd931b17b3b71a038b

Add the secret key in docker-compose.yml file

nano docker-compose.yml

Replace the secret key,

APP_SECRET: "REPLACE_WITH_LONG_SECRET"

to

APP_SECRET: "feae43defc091d1a4bad62290c0808eb47f5b5971952bdcd931b17b3b71a038b"

Save and exit the file.

Start Docmost Containers

Launch Docmost containers using Docker Compose,

docker compose up -d

Output:

root@vps:~/docmost# docker compose up -d
WARN[0000] /root/docker-compose.yml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
[+] Running 38/38
 ✔ docmost Pulled                                                                                                                                                                      88.3s
   ✔ 63786652eaff Pull complete                                                                                                                                                        16.2s
   ✔ 0c2b42acd277 Pull complete                                                                                                                                                        16.4s
   ✔ 4509b69886a5 Pull complete                                                                                                                                                        16.5s
   ✔ 49005139a3b0 Pull complete                                                                                                                                                        17.0s
   ✔ d26c774195fe Pull complete                                                                                                                                                        17.0s
   ✔ 025519373429 Pull complete                                                                                                                                                        18.1s
   ✔ 842095afe6bb Pull complete                                                                                                                                                        18.7s
   ✔ e7944229b848 Pull complete                                                                                                                                                        18.8s
   ✔ f0505953e308 Pull complete                                                                                                                                                        19.0s
   ✔ e05d6a1a9143 Pull complete                                                                                                                                                        19.0s
   ✔ 2f46251b181b Pull complete                                                                                                                                                        19.1s
   ✔ 454cef506a54 Pull complete                                                                                                                                                        19.2s
   ✔ 5a45b67214c7 Pull complete                                                                                                                                                        19.2s
   ✔ 98b0075212e8 Pull complete                                                                                                                                                        21.7s
   ✔ d42aeb81ffe9 Pull complete                                                                                                                                                        22.9s
   ✔ 0f5ac4ba014a Pull complete                                                                                                                                                        86.6s
   ✔ 0da444dc59d6 Pull complete                                                                                                                                                        86.7s
 ✔ db Pulled                                                                                                                                                                           21.3s
   ✔ f18232174bc9 Pull complete                                                                                                                                                         1.2s
   ✔ d3fa5bea7429 Pull complete                                                                                                                                                         1.3s
   ✔ d160f5d84fae Pull complete                                                                                                                                                         1.7s
   ✔ 7cdbcf158508 Pull complete                                                                                                                                                         1.8s
   ✔ ff49b4a326ab Pull complete                                                                                                                                                         1.9s
   ✔ 658bbf5b160b Pull complete                                                                                                                                                        19.6s
   ✔ ad59dcac7955 Pull complete                                                                                                                                                        19.6s
   ✔ fe6f369443b5 Pull complete                                                                                                                                                        19.7s
   ✔ a95aeabeba27 Pull complete                                                                                                                                                        19.7s
   ✔ 59e8ecdd711f Pull complete                                                                                                                                                        19.7s
   ✔ 248166938f44 Pull complete                                                                                                                                                        19.8s
 ✔ redis Pulled                                                                                                                                                                         8.2s
   ✔ 127dd4d24b80 Pull complete                                                                                                                                                         2.0s
   ✔ 9f89c3e18d1a Pull complete                                                                                                                                                         3.3s
   ✔ 90e12913a436 Pull complete                                                                                                                                                         3.6s
   ✔ 7ba0c2a883d2 Pull complete                                                                                                                                                         6.4s
   ✔ 874fcdfb9e55 Pull complete                                                                                                                                                         6.5s
   ✔ 4f4fb700ef54 Pull complete                                                                                                                                                         6.5s
   ✔ 77ef3b7ffa7a Pull complete                                                                                                                                                         6.6s
[+] Running 7/7
 ✔ Network root_default      Created                                                                                                                                                    0.2s
 ✔ Volume "root_db_data"     Created                                                                                                                                                    0.0s
 ✔ Volume "root_redis_data"  Created                                                                                                                                                    0.0s
 ✔ Volume "root_docmost"     Created                                                                                                                                                    0.0s
 ✔ Container root-redis-1    Started                                                                                                                                                    1.0s
 ✔ Container root-db-1       Started                                                                                                                                                    1.0s
 ✔ Container root-docmost-1  Started     

Configure Firewall for Docmost

Enable to firewall using below command,

ufw enable

Output:

root@server:~# ufw enable
Command may disrupt existing ssh connections. Proceed with operation (y|n)? y
Firewall is active and enabled on system startup

Allow incoming traffic on port 3000/tcp for Docmost,

ufw allow 3000/tcp

Output:

root@vps:~/docmost# ufw allow 3000/tcp
Rules updated
Rules updated (v6)
root@vps:~/docmost#

Reload the firewall,

ufw reload

Check the firewall status using below command,

ufw status

Output:

root@vps:~/docmost# ufw status
Status: active

To                         Action      From
--                         ------      ----
3000/tcp                   ALLOW       Anywhere                  
3000/tcp (v6)              ALLOW       Anywhere (v6)             

root@vps:~/docmost#

Restart Docmost Containers

docker compose up -d

Output:

root@vps:~/docmost# docker compose up -d
WARN[0000] /root/docmost/docker-compose.yml: `version` is obsolete 
[+] Running 3/3
 ✔ Container docmost-db-1       Running                                                                                                      0.0s 
 ✔ Container docmost-redis-1    Running                                                                                                      0.0s 
 ✔ Container docmost-docmost-1  Running                                                                                                      0.0s 
root@vps:~/docmost#

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,

http://localhost:3000

Note: Replace the localhost with your actual IP Address

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

image

Click on General to get the Docmost dashboard,

image

You'll see the Docmost dashboard like below,

image

Click on New Page to start to create wiki/document,

image

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


CrownCloud - Get a SSD powered KVM VPS at $4.5/month!
Use the code WELCOME for 10% off!

1 GB RAM / 25 GB SSD / 1 CPU Core / 1 TB Bandwidth per month

Available Locations: LAX | MIA | ATL | FRA | AMS