XWiki is a free wiki software platform written in Java with a design emphasis on extensibility. XWiki is an enterprise wiki. It includes WYSIWYG editing, OpenDocument based document import/export, semantic annotations and tagging, and advanced permissions management. In this step by step guide I will show you how to install XWiki on your Synology NAS using Docker & Portainer.

💡Note: This guide works perfectly with the latest XWiki 16.0.0 release.

• STEP 1

Please Support My work by Making a Donation.

• STEP 2

Install Portainer using my step by step guide. If you already have Portainer installed on your Synology NAS, skip this STEP. Attention: Make sure you have installed the latest Portainer version.

• STEP 3

Go to File Station and open the docker folder. Inside the docker folder, create one new folder and name it xwikidb. Follow the instructions in the image below.
Note: Be careful to enter only lowercase, not uppercase letters.

• STEP 4

Log into Portainer using your username and password. On the left sidebar in Portainer, click on Stacks then + Add stack. Follow the instructions in the image below.

• STEP 5

In the Name field type in xwiki. Follow the instructions in the image below.

Note: Copy Paste the code below in the Portainer Stacks Web editor.

version: '3.7'
services:
  xwiki:
    image: xwiki:16-postgres-tomcat
    container_name: xwiki
    restart: always
    ports:
      - 7894:8080
    links:
      - db
    environment:
      DB_HOST: db
      DB_DATABASE: xwiki
      DB_PASSWORD: xwiki
      TZ: Europe/Bucharest

  db:
    image: postgres
    container_name: xwiki-db
    restart: always
    volumes:
      - /volume1/docker/xwikidb:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=xwiki
      - POSTGRES_PASSWORD=xwiki
      - POSTGRES_DB=xwiki
      - TZ=Europe/Bucharest

Note: Before you paste the code above in the Web editor area below, change the value for TZ. (Select your current Time Zone from this list.)

• STEP 6

Scroll down on the page until you see a button named Deploy the stack. Click on it. Follow the instructions in the image below. The installation process can take up to a few minutes. It will depend on your Internet speed connection.

• STEP 7

If everything goes right, you will see the following message at the top right of your screen: “Success Stack successfully deployed“.

• STEP 8

Go back to STEP 1 or you will deal with karma 🙂.

• STEP 9

Please wait approximately 2-5 minutes for the installation to be completed or you will get a blank page if you try to connect too soon. Now open your browser and type in http://Synology-ip-address:7894 Wait for XWiki to initialize. Follow the instructions in the image below.

• STEP 10

Click Continue to register a new admin user. Follow the instructions in the image below.

• STEP 11

Add your own credentials then click Register and login. Follow the instructions in the image below.

• STEP 12

You are now connected with the administrator user. Click Continue. Follow the instructions in the image below.

• STEP 13

Select XWiki Standard Flavor 16 then click Install this flavor. Follow the instructions in the image below.

• STEP 14

Click Install. Follow the instructions in the image below.

• STEP 15

The installation process will start. Follow the instructions in the image below.

• STEP 16

Click Continue to install all the default applications. Follow the instructions in the image below.

• STEP 17

The installation process of the applications will start. Follow the instructions in the image below.

• STEP 18

If you get any errors during the installation, select “Resolve Automatically” then click Continue. Follow the instructions in the image below.

• STEP 19

After all the applications are installed, click Continue. Follow the instructions in the image below.

• STEP 20

Click Continue to confirm. Follow the instructions in the image below.

• STEP 21

Go back to STEP 1 or you will deal with karma 🙂.

• STEP 22

Welcome to XWiki! Click Next to discover your wiki’s interface and basic functionalities. Follow the instructions in the image below.

Enjoy XWiki!

Note: If you want to run the XWiki container over HTTPS, check my guide on How to Run Docker Containers Over HTTPS.

Note: Can I run Docker on my Synology NAS? See the supported models.
Note: How to Back Up Docker Containers on your Synology NAS.
Note: Find out how to update the XWiki container with the latest image.
Note: How to Free Disk Space on Your NAS if You Run Docker.
Note: How to Schedule Start & Stop For Docker Containers.
Note: How to Activate Email Notifications.
Note: How to Add Access Control Profile on Your NAS.
Note: How to Change Docker Containers Restart Policy.
Note: How to Use Docker Containers With VPN.
Note: Convert Docker Run Into Docker Compose.
Note: How to Clean Docker.
Note: How to Clean Docker Automatically.
Note: Best Practices When Using Docker and DDNS.
Note: Some Docker Containers Need WebSocket.
Note: Find out the Best NAS Models For Docker.
Note: Activate Gmail SMTP For Docker Containers.

This post was updated on Saturday / February 24th, 2024 at 7:14 PM