Bringing up a TWiki Docker Instance - Revision history

PeterHarding at 05:13, 28 January 2026

2026-01-28T05:13:15Z

← Older revision		Revision as of 15:13, 28 January 2026
Line 163:		Line 163:
	As soon as I added this and restated Apache theauthentication started to succeed.		As soon as I added this and restated Apache theauthentication started to succeed.

			OK now that I have that working I am going to re-enble BasicAuth on the site to protect the information.

			= Approach Two =

			Using docker compose with a customize Docker image.

PeterHarding at 05:11, 28 January 2026

2026-01-28T05:11:11Z

← Older revision		Revision as of 15:11, 28 January 2026
Line 138:		Line 138:
	$TWiki::cfg{Htpasswd}{Encoding} = 'md5';		$TWiki::cfg{Htpasswd}{Encoding} = 'md5';
	</pre>		</pre>

			Of course, after any of the changes you will need to restart Apache to get the changes to take effect.

			The data/CPN/WebPreferences.tx file contains a block which controls document access:

			<pre>
			* Users or groups who __are not__ / __are__ allowed to __view__ / __change__ / __rename__ topics in the %WEB% web: (See %TWIKIWEB%.TWikiAccessControl)
			* Set DENYWEBVIEW =
			* Set ALLOWWEBVIEW = *
			* Set DENYWEBCHANGE = Main.TWikiGuest
			* Set ALLOWWEBCHANGE = Main.Study754Group, admin
			* Set DENYWEBRENAME = Main.TWikiGuest, admin
			* Set ALLOWWEBRENAME = Main.Study754Group, admin
			</pre>

			To allow access you can either use '= *' to open it up completeley of add ', admin' to allow admin to access the content.

			Despite doing this the authentication still failed. The final requirement was to get Apache to honour the HTTPS headers by adding the following to /etc/apache2/sites-enabeled/twiki.conf:

			<pre>
			SetEnvIf X-Forwarded-Proto "https" HTTPS=on
			</pre>

			As soon as I added this and restated Apache theauthentication started to succeed.

PeterHarding at 05:04, 28 January 2026

2026-01-28T05:04:37Z

@@ Line 72: / Line 72: @@
 [[File: TWiki_Site_Map.jpg]]
-However, this content is password protected.
+However, this content is password protected and required a bit of work to get running.
 <pre>
 </pre>

PeterHarding at 04:45, 28 January 2026

2026-01-28T04:45:42Z

← Older revision		Revision as of 14:45, 28 January 2026
Line 70:		Line 70:
	</pre>		</pre>

			[[File: TWiki_Site_Map.jpg]]

			However, this content is password protected.

	<pre>		<pre>

PeterHarding: Created page with "I am in the process of recovering a TWiki installation for a client. I have been given a tar archive containing the /data and /pub for the organizations internal TWiki data. I want to bring it up as a Docker instance with an NGINX reverse proxy exposing it to the outside world via HTTPS. = Approach One = Use an existing Docker TWiki. I found a number of possible solution of various vintages. * https://github.com/mharrend/docker-twiki * https://hub.docker.com/r/open..."

2026-01-28T04:42:07Z

Created page with "I am in the process of recovering a TWiki installation for a client. I have been given a tar archive containing the /data and /pub for the organizations internal TWiki data. I want to bring it up as a Docker instance with an NGINX reverse proxy exposing it to the outside world via HTTPS. = Approach One = Use an existing Docker TWiki. I found a number of possible solution of various vintages. * https://github.com/mharrend/docker-twiki * https://hub.docker.com/r/open..."

New page

I am in the process of recovering a TWiki installation for a client. I have been given a tar archive containing the /data and /pub for the organizations internal TWiki data. I want to bring it up as a Docker instance with an NGINX reverse proxy exposing it to the outside world via HTTPS.

= Approach One =

Use an existing Docker TWiki.

I found a number of possible solution of various vintages.

* https://github.com/mharrend/docker-twiki
* https://hub.docker.com/r/opensciencegrid/docker-twiki-converter/
*

After some investigation I settled on -

* https://hub.docker.com/r/heradon/twiki

I got it working initially using HTTP on a PC running docker locally to understand how the pieces fitted together.

I then moved it across to a Linux server where I could front it with an NGINX revers proxy.

Here are the basic stages:

== 1. Get the Docker Container Running ==

This was achieved using a simple shell script as follows:

<pre>
#!/bin/sh

docker run -dt -p 8219:80 -v ./wiki/:/wiki -e URL_HOST=http://127.0.0.1:8219/ -e ADMIN_PW=Secret --name twiki --rm heradon/twiki
</pre>

In this case the NGINX proxy is redirecting to http://127.0.0.1:8219 - thus the ports used above.

The local ./wiki directory contains pub and data directories from the old TWiki site each of which contain a CFP directory with the custom wiki data

Once I had the container running I could see the Main, TWiki and Sandbox default TWiki content.

== 2. Retrofit the CFP Data ==

The underlying TWiki Docker installation lives in /var/www/twiki. This folder conatains (among others) a 'pub' and 'data' folder which contain the default TWiki contents. As part of the Docker container initialization the run script moves twiki/data and twiki/pub to /data/data and /data/pub and then sym-links these back into /var/www/twiki.

This process collided with my initial Docker setup which mapped a local ./data to /data in the container - and this broke the internal container application setup as the run script directory re-work failed. As a result I mounted the client CFP data in ./wiki and once the container was up an running I copied it across to combine the custom site data with the generic TWiki data.

Once I had this worked out I was able to connect to the container and put the custom content in place:

<pre>
$ docker exec -it twiki bash
% cd /data/pub
% cp -r /wiki/pub/CFP .
% cd /data/data
% cp -r /wiki/data/CFP .
</pre>

And so the data was now in place:

<pre>
root@5db33ad05760:/data# ls -l data
total 116
drwxrwxr-x 2 www-data www-data 4096 Jan 28 04:02 CFP
drwxrwxr-x 2 www-data www-data 4096 Jul 16 2018 Main
drwxrwxr-x 2 www-data www-data 4096 Jul 16 2018 Sandbox
drwxrwxr-x 2 www-data www-data 73728 Jul 16 2018 TWiki
drwxrwxr-x 2 www-data www-data 4096 Jul 16 2018 Trash
drwxrwxr-x 2 www-data www-data 4096 Jul 16 2018 _default
drwxrwxr-x 2 www-data www-data 4096 Jul 16 2018 _empty
-rwxrwxr-x 1 www-data www-data 337 Jan 28 04:06 log202601.txt
-rwxrwxr-x 1 www-data www-data 9024 Jul 16 2018 mime.types
</pre>

<pre>
</pre>

[[Category:TWIKI]]
[[Category:Wiki]]
[[Category:Perl]]