Skip to Content
Last modified by Alexandru Pentilescu on 2023/06/25 18:56
From version 34.1
edited by Alexandru Pentilescu
on 2022/06/09 22:14
Change comment: There is no comment for this version
To version 30.1
edited by Alexandru Pentilescu
on 2022/06/08 22:22
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -9,9 +9,7 @@
9 9  
10 10  With all of these details in mind, let's begin!
11 11  
12 -{{box title="**Contents**"}}
13 13  {{toc /}}
14 -{{/box}}
15 15  
16 16  ----
17 17  
... ... @@ -197,49 +197,11 @@
197 197  
198 198  If errors are reported, please review your configuration files and repair all the detected issues. If everything is fine then issue a "sudo systemctl restart nginx" and then you're pretty much good to go!
199 199  
200 -= Retrieving files for installing the Standard flavor packages and all its extensions =
201 -
198 += Retrieving files for installing the Standard flavor packages and all its extensions=
202 202  While the docker container contains all the necessary system utilities to run the XWiki server internally, a lot of functionality for the Wiki will be missing as it is.
203 203  The XWiki container is very lackluster even in administration features and not installing the Standard flavor will give you a very barebones and almost functionally broken experience. As such, while optional, it is very strongly encouraged to install the Standard flavor along with XWiki to activate many of its most basic features.
204 204  To do so, we will have to download a very specific XIP package from XWiki's download portal. Visit [[here>>https://www.xwiki.org/xwiki/bin/view/Download/]] this aforementioned download portal and click the "Download" button for the Long Term Support option on that page. On the new page, click the "Download" button for the "XIP Package" section. This will allow you to download the XIP package in question to your local computer.
205 205  Unzip the contents of this XIP package (XIP is just a specific flavor of a ZIP archive so you can just rename the file to use the ".zip" extension if your archive program doesn't recognize it) and upload the unzipped contents to the server where the docker image of XWiki is running, under the "data/xwiki-data/data/extension/repository/" subdirectory of your XWiki directory.
206 -Once this has been done, you may issue a "docker-compose up -d" again to start up the XWiki engine once again. Now that the files have been delivered to their expected disk location and are accessible to the engine, you will be good to go to install them efficiently.
207 -There are other means of installing the Standard flavor as well, as detailed [[here>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Installation/#HOthermethods]]. Choose whichever alternative you wish!
208 -
209 -Once the XWiki engine has initialized its start state properly, you may visit your XWiki instance by going into the browser and accessing the wiki via your Nginx configured subdomain, rather than by port 8081 as we previously did. If you opted to also configure Nginx to inject TLS into the connection, you should now see the green lock in your web browser, next to the address bar, indicating that your connection to your server is encrypted and protected from any network sniffers. You may now proceed to both create an administrative account, as well as install the Standard flavor.
210 -
211 -
212 -= Initial XWiki setup for administrative account and installing the Standard flavor =
213 -
214 -At this point, you should see the following image in your browser again:
215 -[[image:Screenshot_20220607_015727.png]]
216 -
217 -It's finally time to setup the administration account! This account will have full privileges throghout the wiki and will be able to view and edit anything and everything. As such, please use a very strong password to protect it from password stuffing attacks!
218 -If in doubt, always use a password manager like Bitwarden to generate strong, long passwords for you! These are guarenteed to have high entropy and are resistant to dictionary attacks.
219 -
220 -Fill in all the details for your account, as detailed in the image below:
221 -[[image:Screenshot_20220607_015843.png]]
222 -
223 -Press the "Register and login" button to immediately login as the newly created user. Once this is done, we can proceed with the Standard flavor installation, as shown below:
224 -[[image:Screenshot_20220607_020931.png]]
225 -
226 -The "XWiki Standard Flavor" option should appear in the FLAVOR window by default if you downloaded the aforementioned XIP package and extracted its contents via the upload I already described in the proper directory. This flavor is ready to be installed now. Press the "Install this flavor" and let's get this show going!
227 -You should come up to the following screen:
228 -[[image:Screenshot_20220607_020959.png]]
229 -
230 -Press "Install".
231 -
232 -After some time, the following screen should appear:
233 -[[image:Screenshot_20220607_021031.png]]
234 -
235 -Press "Continue". Admittedly, this took several attempts on my end. I had to press "Continue" multiple times and a Time-out error appeared many times over, indicating that the process failed at some point.
236 -
237 -Not sure what was wrong, or what was even timing out. All the packages were supposed to already be provided by the XIP package which I already unarchived, so all the files should have been locally accessible for the server. Was it downloading something else in the process? Don't know.
238 -If you encounter a similar bug, please be persistent and keep on pressing "Continue" for another couple of times, like I did, around 3 or 4 times. If no progress is being made, press the "Later" button instead. If that button is disabled, press the "Select other flavor" at the top first and then press "Later", so that the installation of the Standard flavor is skipped. I did that and eventually it took me to the full Wiki page.
239 -Proceed through the next installation steps and eventually finish the setup wizard entirely.
240 -Once this is done, you should be directed to your XWiki's greeting page!
241 -Congratulations, you've finished your first installation!
242 -
243 243  = External references =
244 244  
245 245  [[Official docker guide for installing XWiki>>https://github.com/xwiki/xwiki-docker/blob/master/README.md]]