How to Install XWiki on Your Synology NAS

How to Install XWiki on Your Synology NAS

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 14.6 release.

  • STEP 1

Please Support My work by Making a Donation.

  • STEP 2

Install Docker via Synology “Package Center”.

Install Docker Synology DSM 7

  • STEP 3

Install Portainer using my step by step guide. If you already have Portainer installed on your Synology NAS, skip this STEP.

  • STEP 4

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.

XWiki Synology NAS Set up 1

  • STEP 5

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.

XWiki Synology NAS Set up 2

  • STEP 6

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:14.6-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.)

XWiki Synology NAS Set up 3

  • STEP 7

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.

XWiki Synology NAS Set up 4

  • STEP 8

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

XWiki Synology NAS Set up 5

  • STEP 9

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

  • STEP 10

Please wait approximately 2 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.

XWiki Synology NAS Set up 6

  • STEP 11

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

XWiki Synology NAS Set up 7

  • STEP 12

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

XWiki Synology NAS Set up 8

  • STEP 13

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

XWiki Synology NAS Set up 9

  • STEP 14

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

XWiki Synology NAS Set up 10

  • STEP 15

Click Install. Follow the instructions in the image below.

XWiki Synology NAS Set up 11

  • STEP 16

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

XWiki Synology NAS Set up 12

  • STEP 17

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

XWiki Synology NAS Set up 13

  • STEP 18

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

XWiki Synology NAS Set up 14

  • STEP 19

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

XWiki Synology NAS Set up 15

  • STEP 20

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

XWiki Synology NAS Set up 16

  • STEP 21

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

XWiki Synology NAS Set up 17

  • STEP 22

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

  • STEP 23

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

XWiki Synology NAS Set up 18

Enjoy XWiki!

XWiki Synology NAS Set up 19

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: 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: Some Docker Containers Need WebSocket.

This post was updated on Monday / August 1st, 2022 at 11:35 AM