Skip to Content
Last modified by Alexandru Pentilescu on 2023/06/25 18:56
From version 55.1
edited by Alexandru Pentilescu
on 2022/06/15 22:58
Change comment: There is no comment for this version
To version 51.1
edited by Alexandru Pentilescu
on 2022/06/12 07:21
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -5,7 +5,7 @@
5 5  * You have sudo rights on the machine where you're trying to install the XWiki server on
6 6  * This machine already has docker fully installed and properly configured on it. Please perform a test installation of any random image from docker hub to ensure that everything works appropriately
7 7  * You already own and are in control of a domain name for which you wish to make the XWiki server accessible through. This domain name is already pre-configured to point to the server that you wish to install XWiki on. In my particular case, I already have pentilescu.com configured to point to my VPS and, what I wished to accomplish was to have a subdomain via which I could access XWiki. In this particular case, this subdomain was wiki.pentilescu.com. To that end, you must have nginx also configured and running on the same server in the background, to have it redirect connections whose destination is a specific port to a subdomain
8 -* Finally, it's recommended (although not mandatory) to have an SMTP email server running somewhere accessible to the docker instance. XWiki will need to use this server to relay account activation emails as well as password reset emails to its users
8 +* Finally, you must have an SMTP email server running somewhere accessible to the docker instance. XWiki will need to use this server to relay account activation emails as well as password reset emails to its users
9 9  
10 10  With all of these details in mind, let's begin!
11 11  
... ... @@ -54,7 +54,7 @@
54 54  # ---------------------------------------------------------------------------
55 55  version: '2'
56 56  networks:
57 - internal_xwiki_network:
57 + bridge:
58 58   driver: bridge
59 59  services:
60 60   # The container that runs XWiki + Tomcat
... ... @@ -78,8 +78,8 @@
78 78   volumes:
79 79   - ./data/xwiki-data:/usr/local/xwiki
80 80   networks:
81 - - internal_xwiki_network
82 -
81 + internal_xwiki_network:
82 + ipv4_address: 192.168.80.3
83 83   # The container that runs the database (mariadb)
84 84   db:
85 85   image: "mariadb:10.5"
... ... @@ -103,7 +103,8 @@
103 103   - MYSQL_PASSWORD=${DB_PASSWORD}
104 104   - MYSQL_DATABASE=${DB_DATABASE}
105 105   networks:
106 - - internal_xwiki_network
106 + internal_xwiki_network:
107 + ipv4_address: 192.168.80.4
107 107  
108 108  networks:
109 109   internal_xwiki_network:
... ... @@ -132,6 +132,7 @@
132 132  
133 133  Please replace <database_password> and <mysql_root_password> with randomly generated long strings, preferrably containing a long sequence of lowercase, uppercase letters, digits and symbols. In my case, I chose 12 character long sequences for each of them. It's unlikely for a hacker to compromise your docker environment but it's still best practice to make the passwords as long and hard to guess as possible, as an extra layer of security.
134 134  
136 +
135 135  = First run of the container =
136 136  
137 137  The first run is always the scariest. Start up the docker image and wait for everything to initialize:
... ... @@ -156,7 +156,7 @@
156 156  
157 157  For the time being, press the "Later" button on the dialog (not the "Never" one!) and then run a "docker-compose down" to stop the container from running. The first test run was a success! Congratulations!
158 158  
159 -= [OPTIONAL] Nginx reverse proxy configuration =
161 += Nginx reverse proxy configuration =
160 160  
161 161  We assume you already have Nginx installed and properly configured on your machine. Also, we will assume you have an X.509 certificate whose Subject Alt Names includes both your domain name, as well as the subdomain for your wiki (i.e. in my case for pentilescu.com and wiki.pentilescu.com, respectively) and you've configured Nginx to utilize both of them! If this is not the case or you're unsure how to perform these configurations, please check the internal "How to setup an Nginx reverse proxy and also provide a global X.509 certificate for it" guide at the bottom of this page.
162 162  
... ... @@ -300,4 +300,4 @@
300 300  
301 301  [[Official docker guide for installing XWiki>>https://github.com/xwiki/xwiki-docker/blob/master/README.md]]
302 302  [[How to setup an Nginx reverse proxy and also provide a global X.509 certificate for it>>https://wiki.pentilescu.com/bin/view/Guides/How%20to%20setup%20an%20Nginx%20reverse%20proxy%20and%20also%20provide%20a%20global%20X.509%20certificate%20for%20it/]]
303 -[[How to setup a postfix SMTP server>>https://wiki.pentilescu.com/bin/view/Guides/How%20to%20setup%20a%20postfix%20SMTP%20server/]]
305 +How to setup a postfix SMTP server [NOT YET WRITTEN]