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,
Click on General to get the Docmost dashboard,
You'll see the Docmost dashboard like below,
Click on New Page to start to create wiki/document,
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