How to Install and Configure Wiki.js on Ubuntu 25.10 (Using Docker)

---

Wiki.js is a modern, powerful, and open-source wiki application built on Node.js. It supports Markdown editing, authentication methods, visual themes, and integrates with various storage backends like PostgreSQL, Git, and more. In this guide, we’ll install Wiki.js on Ubuntu 25.10 using Docker.

Update Your System

---

Before installing Docker and Wiki.js, make sure your system packages are up to date.

apt update -y
apt upgrade -y

Install Docker and Docker Compose

---

Install the required dependencies and Docker’s official repository.

apt install -y ca-certificates curl gnupg lsb-release
mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null
apt update
apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

Enable and start Docker:

systemctl enable docker
systemctl start docker

Set Up Wiki.js Environment

---

Create a directory for Wiki.js and generate a database secret.

mkdir -p /etc/wiki
openssl rand -base64 32 > /etc/wiki/.db-secret

Create an internal Docker network and a persistent PostgreSQL volume.

docker network create wikinet
docker volume create pgdata

Deploy PostgreSQL Container

---

We’ll use PostgreSQL 15 as the database backend for Wiki.js.

docker run -d --name db \
  --network wikinet \
  -e POSTGRES_DB=wiki \
  -e POSTGRES_USER=wikijs \
  -e POSTGRES_PASSWORD_FILE=/etc/wiki/.db-secret \
  -v /etc/wiki/.db-secret:/etc/wiki/.db-secret:ro \
  -v pgdata:/var/lib/postgresql/data \
  --restart unless-stopped \
  postgres:15

Deploy Wiki.js Container

---

Now, pull and run the latest Wiki.js container.

docker rm -f wiki
docker run -d --name wiki \
  --network wikinet \
  -e DB_TYPE=postgres \
  -e DB_HOST=db \
  -e DB_PORT=5432 \
  -e DB_USER=wikijs \
  -e DB_PASS=$(cat /etc/wiki/.db-secret) \
  -e DB_NAME=wiki \
  -p 80:3000 \
  -p 443:3443 \
  --restart unless-stopped \
  ghcr.io/requarks/wiki:3.0.0-alpha

Deploy Wiki.js Update Companion

---

The update companion helps automate version checks and updates for Wiki.js.

docker run -d --name wiki-update-companion \
  --network wikinet \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  --restart unless-stopped \
  ghcr.io/requarks/wiki-update-companion:latest

Configure Firewall (Optional)

---

Allow SSH, HTTP, and HTTPS traffic to ensure remote accessibility.

ufw allow ssh
ufw allow http
ufw allow https
ufw --force enable

Access Wiki.js Setup Wizard

---

Once all containers are running, open your browser and go to:

http://your-server-ip/

Replace your-server-ip with your actual server IP address or domain name.

You will see the Wiki.js setup wizard, where you can configure your admin account and start using the platform.

Done

---

You’ve successfully installed and configured Wiki.js on Ubuntu 25.10 using Docker.
Your wiki is now ready to use and can be managed easily via the web interface.