Skip to Content
Last modified by Alexandru Pentilescu on 2023/06/25 18:56
From version 6.1
edited by Alexandru Pentilescu
on 2022/06/08 21:08
Change comment: There is no comment for this version
To version 16.1
edited by Alexandru Pentilescu
on 2022/06/08 21:32
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -130,12 +130,34 @@
130 130  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.
131 131  
132 132  
133 -= First run of the container=
133 += First run of the container =
134 +
134 134  The first run is always the scariest. Start up the docker image and wait for everything to initialize:
136 +
135 135  {{code language="bash"}}
136 136  docker-compose up -d
137 137  {{/code}}
138 138  
141 +If you followed along just the way I described in this article, you shouldn't have any problems with this step. Note that XWiki takes a significant amount of time to initialize, around 10 minutes.
142 +
143 +Take your time and don't rush!
144 +
145 +When you want to see the status of your installation, visit the domain name pointing to your server at port 8081. In my case, I would visit http://pentilescu.com:8081/
146 +
147 +You might see a page indicating that XWiki is initializing, as well as a percentage counter indicating its progress. Let the server finish doing its thing.
148 +
149 +In the end, you should see an image like the one below:
150 +
151 +[[image:Screenshot_20220607_015727.png]]
152 +
153 +**While it may be tempting to immediately try to setup an administrator account from this portal, unless you're browsing this page from localhost (i.e. the XWiki server is on the exact same machine that you're running your web browser from) DO NOT register an account YET! All traffic is unencrypted to the server and may be intercepted by anyone sniffing your internet packets. We must first configure an X.509 TLS certificate with Nginx and configure Nginx to act as a reverse proxy for this wiki**
154 +
155 +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!
156 +
157 += Nginx reverse proxy configuration=
158 +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.
159 +
139 139  = External references =
140 140  
141 141  [[Official docker guide for installing XWiki>>https://github.com/xwiki/xwiki-docker/blob/master/README.md]]
163 +How to setup an Nginx reverse proxy and also provide a global X.509 certificate for it -- NOT YET WRITTEN!
Screenshot_20220607_015727.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.AlexandruPentilescu
Size
... ... @@ -1,0 +1,1 @@
1 +218.6 KB
Content