## page was renamed from TjadosForum
#acl All:read,write

This page is about the Docker container setup for Tjado's homeopathy forum.

<<TableOfContents(2)>>

The tjado forum runs on elba.informatik.uni-freiburg.de.
It consists of the docker container "forum" with an Apache which serves the phpBB, and the docker container "mariadb" with the database.

= Data locations =

All data related to the docker container is in /home/docker/tjado/ . To migrate or backup the docker containers, just copying this folder is required.
The actual forum data (phpBB files) is located inside /home/docker/tjado/forum-data and the SQL database data is in /home/docker/tjado/docker-volumes/

== Changing the text for the Terms of Use (Nutzungsvereinbarung) ==

The text for the current terms of use is contained in the file ''/home/docker/tjado/forum-data/tjado/forum/language/de/ucp.php'' (starting from line 42).

== Adding an Imprint (Impressum) ==

The overall footer can be edited in ''/home/docker/tjado/forum-data/tjado/forum/styles/subsilver2/template/overall_footer.html'' (this is a short file).

The overall header can be edited in ''/home/docker/tjado/forum-data/tjado/forum/styles/subsilver2/template/overall_header.html''. To insert a link to the left of the FAQ link, go to line 177 (search FAQ). To insert a link after the title on the very top, go to line 157 (search SITENAME).

For these edits to become active, empty the caches (Adminstratiosnbereich -> "Den Cache leeren" -> "Jetzt ausführen").


= How to stop/restart =
To stop or restart the "forum" or "mariadb" container, use this command:

{{{
cd /home/docker/tjado && sudo docker-compose restart forum
}}}

.. or with stop instead of restart respectively.

(the cd is necessary because docker-compose accesses the docker-compose.yml in /home/docker/tjado for settings)

If the containers aren't running, use the following command:

{{{
cd /home/docker/tjado && sudo-docker-compose up -d forum
}}}

(and with mariadb respectively)

= How to get a shell =
The containers work similarly to a virtual machine which an own contained linux install.
To get a shell in the forum container with the Apache, run:

{{{
cd /home/docker/tjado && sudo docker-compose exec forum /bin/bash
}}}

and respectively for the forum:

{{{
cd /home/docker/tjado && sudo docker-compose exec mariadb /bin/bash
}}}

= Detailed container settings =

The detailed container settings can be found in /home/docker/tjado/docker-compose.yml for both containers, including the current SQL root password.
The build instructions (what software is preinstalled in the containers) can be found in /home/docker/tjado/dockerfile-forums/Dockerfile and /home/docker/tjado/dockerfile-mariadb/Dockerfile .

= How to make an independent copy of the forum =

{{{
ssh elba
cd /home/docker/tjado && docker-compose stop
sudo cp -a /home/docker/tjado /home/docker/tjado-tmp-copy
}}}