Changes for page How to setup an XWiki docker container

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -113,6 +113,30 @@
113	113
114	114	There are many different configurations you can use to have an XWiki server. For one, mariadb is NOT required to install XWiki, it's simply one of many database solutions that XWiki is compatible with. Alternatively, you may use MySQL or even PostgreSQL, instead. To see docker-compose configuration options for those, please reference the full official docker reference guide for XWiki at the "External references" section of this page for more details. **Keep in mind, though, in case you do decide to use an alternative to mariadb, to download a different init.sql file than the one mentioned in the previous step!**
115	115
	116	+Finally, in the current directory that you are in, please create another subdirectory called "data" containing the empty subdirectories "mariadb-data" and "xwiki-data". The mariadb-data directory will contain all the persistent data from the database and the xwiki-data will contain the persistent data with respect to our XWiki installation, such as XWiki extensions, icons, as well as user-uploaded attachments.
116	116
	118	+One last note: the subnet 192.168.80.x IP address space configured for our docker network may be changed to whatever suits your particular needs, although, if you do use a different IP space, please keep in mind to also change the reference "mynetworks" configuration for postfix accordingly, as explained in the "Configuring Postfix to send XWiki emails" section of this page.
	119	+
	120	+Now, all we need to do is create a ".env" file in the main directory ("xwiki" is the name of my directory) containing the following contents:
	121	+
	122	+{{code language="ini"}}
	123	+DB_USER=xwiki
	124	+DB_PASSWORD=<database_password>
	125	+MYSQL_ROOT_PASSWORD=<mysql_root_password>
	126	+DB_DATABASE=xwiki
	127	+XWIKI_VERSION=1.0
	128	+{{/code}}
	129	+
	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	+
	132	+
	133	+= First run of the container=
	134	+The first run is always the scariest. Start up the docker image and wait for everything to initialize:
	135	+
	136	+{{code language="bash"}}
	137	+docker-compose up -d
	138	+{{/code}}
	139	+
117	117	= External references =
	141	+
118	118	[[Official docker guide for installing XWiki>>https://github.com/xwiki/xwiki-docker/blob/master/README.md]]