Install Wiki.js with Docker Compose
This article is for those looking for a detailed and straightforward guide on installing Wiki.js with Docker Compose.
Wiki.js is a wiki engine running on Node.js and written in JavaScript. It is free software released under the Affero GNU General Public License.
In this guide, we will consider the case when you already have a server with the Ubuntu Server 22.04 LTS operating system installed on it.
You can read more about how to install Ubuntu Server 22.04 LTS in my guide “Install Ubuntu Server 22.04 LTS”.
Also, the server must have Docker Engine and Docker Compose installed.
You can learn how to install Docker Engine and Docker Compose on Ubuntu Server by reading “Install Docker Engine and Docker Compose on Ubuntu Server”.
In addition, OpenSSH must be installed on the server, and port 22 must be open in order to be able to connect to the server using the SSH protocol.
To install OpenSSH on a server, you can use the command:
sudo apt install openssh-serverIf you plan to connect to the server using the Windows operating system, you can use PuTTY or MobaXterm.
This guide describes how to connect to a server using the iTerm2 terminal emulator installed on the macOS operating system.
Please note that you will need to open the following TCP ports to access your server:
- TCP port 80 - to receive a free cryptographic certificate through the Let’s Encrypt CA.
- TCP port 443 - to access the Wiki.js web interface.
We connect to the server on which you plan to install Docker Compose.
Now you need to create a YAML configuration file that will contain all the necessary conditions for Docker Compose to work.
Let’s create a YAML configuration file using a text editor using the command:
vim wikijs-traefik-letsencrypt-docker-compose.yml
Hit the “i” button to go into edit mode, then insert the following configuration for Wiki.js to work.
Next, you need to make changes to the configuration so that the contents of the file match your conditions. Parameters that need to be checked or changed are marked “(replace with yours)”.
In this guide, the wikijs.heyvaldemar.net subdomain will be used to access Wiki.js from the Internet. You will need to specify your domain or subdomain by which your Wiki.js will be accessible from the Internet.
Please note that in this guide, Postgres will be used as a database management system, and Traefik will be used as a reverse proxy.
In the “traefik.http.middlewares.authtraefik.basicauth.users” parameter, you must specify the username and password hash to access the Traefik dashboard.
Please note that you can use this service to get the password hash.
Now press the “Esc” button to exit edit mode, then type “:x” and press the “Enter” button to save your changes and exit the editor.
Now let’s start Wiki.js with the command:
docker compose -f wikijs-traefik-letsencrypt-docker-compose.yml -p wikijs up -d
To continue the XWiki installation process, you need to go from the workstation to the link https://wikijs.heyvaldemar.net, where wikijs.heyvaldemar.net is the name of my server. Accordingly, you need to provide the name of your Wiki.js. server.
The next step is to provide: an email address and a password to create a Wiki.js administrator account.
In the “Site URL” field, specify your domain or subdomain where your Wiki.js is. will be available on the Internet.
Click on the “Install” button.
Next, specify the email address and password for the Wiki.js administrator account that was created earlier.
Click on the “Log In” button.
Welcome to the Wiki.js control panel.
To access the Traefik control panel, go to the link https://traefik.wikijs.heyvaldemar.net from the workstation, where traefik.wikijs.heyvaldemar.net is the name of my server. Accordingly, you need to specify the name of your server with Traefik installed.
Specify the username and password specified earlier in the YAML configuration file and click on the “OK” button.
Welcome to the Traefik dashboard.
Patreon Exclusives
Join my Patreon and dive deep into the world of Docker and DevOps with exclusive content tailored for IT enthusiasts and professionals. As your experienced guide, I offer a range of membership tiers designed to suit everyone from newbies to IT experts so you will get
What You’ll Get
🏆 Patron-Only Posts: Gain access to in-depth posts that provide a closer look at Docker and DevOps techniques, including step-by-step guides, advanced tips, and detailed analysis not available to the general public.
🏆 Early Access: Be the first to view new content and tutorials, giving you a head start on the latest technologies and methods in the IT world.
🏆 Priority Support: Have your specific questions and challenges addressed with priority, ensuring you get the most tailored and direct support possible.
🏆 Influence Future Content: Your suggestions and feedback directly influence the topics and tutorials I create, making sure the content is highly relevant and useful to your needs.
🏆 Recognition and Interaction: Active participants and supporters receive shout-outs in videos and public streams, acknowledging your important role in our community.
🏆 Special Discounts: Enjoy discounts on courses and future events, exclusively available to Patreon members.
🏆 Networking Opportunities: Connect with other IT professionals and enthusiasts in a supportive and engaging environment, expanding your network and learning collaboratively.
🏆 Heartfelt Gratitude and Updates: My personal thanks for your support, which fuels the creation of more content and allows continuous improvement and expansion.
Join me now and start your journey to mastering Docker and DevOps with exclusive insights and a supportive community!
My Courses
🎓 Dive into my comprehensive IT courses designed for enthusiasts and professionals alike. Whether you’re looking to master Docker, conquer Kubernetes, or advance your DevOps skills, my courses provide a structured pathway to enhancing your technical prowess.
My Services
💼 Take a look at my service catalog and find out how we can make your technological life better. Whether it’s increasing the efficiency of your IT infrastructure, advancing your career, or expanding your technological horizons — I’m here to help you achieve your goals. From DevOps transformations to building gaming computers — let’s make your technology unparalleled!
Refill My Coffee Supplies
💖 PayPal
🏆 Patreon
💎 GitHub
🥤 BuyMeaCoffee
🍪 Ko-fi
Follow Me
🎬 YouTube
🐦 Twitter
🎨 Instagram
🐘 Mastodon
🧵 Threads
🎸 Facebook
🧊 Bluesky
🎥 TikTok
💻 LinkedIn
📣 daily.dev Squad
🧩 LeetCode
🐈 GitHub
Is this content AI-generated?
Nope! Each article is crafted by me, fueled by a deep passion for Docker and decades of IT expertise. While I employ AI to refine the grammar—ensuring the technical details are conveyed clearly—the insights, strategies, and guidance are purely my own. This approach may occasionally activate AI detectors, but you can be certain that the underlying knowledge and experiences are authentically mine.
