Documentation:Wiki Deployment - Revision history

Josh: Updated documentation from markdown files

2026-05-16T14:45:30Z

Updated documentation from markdown files

← Older revision		Revision as of 14:45, 16 May 2026
Line 52:		Line 52:
	<pre class="lang-bash">		<pre class="lang-bash">
	cd /var/www/wiki.jb		cd /var/www/wiki.jb
	~~source~~ .~~env~~		bash scripts/backup-wikis.sh
	~~mkdir -p backups~~		</pre>
	~~docker compose exec -T mariadb mariadb-dump -uroot -p"$MARIADB_ROOT_PASSWORD" mediawiki \~~
	> backups/mediawiki~~-$(date +%F)~~.sql		Creates <code>backups/YYYY-MM-DD/</code> with <code>mediawiki.sql</code>, <code>mediawiki_werbs.sql</code>, and <code>wiki-images.tar.gz</code>. Deletes backup folders older than 30 days (<code>RETENTION_DAYS=0</code> to disable pruning).
	~~docker compose exec -T mariadb mariadb-dump -uroot -p"$MARIADB_ROOT_PASSWORD" mediawiki_werbs \~~
	> ~~backups/~~mediawiki_werbs~~-$(date +%F)~~.sql		Weekly cron (root):
	~~tar -czf backups~~/wiki-images~~-$(date +%F)~~.tar.gz wiki/~~images werbs~~-wiki~~/images~~
			<pre class="lang-cron">
			0 3 '' '' 0 /var/www/wiki.jb/scripts/backup-wikis.sh >> /var/log/wiki-backup.log 2>&1
	</pre>		</pre>

Line 71:		Line 73:

	Logos after image restores: <code>bash scripts/fix-logos.sh</code>		Logos after image restores: <code>bash scripts/fix-logos.sh</code>

			== Extensions ==

			The VPS <code>LocalSettings.php</code> files use the '''default MediaWiki 1.44 extension set''' from the installer (skins only unless you add more). Content was imported from the NAS farm; per-wiki farm files (<code>LocalSettings_wiki.php</code>, <code>LocalSettings_werbs-wiki.php</code>) are not on this server.

			To restore NAS-only extensions:

			# Copy farm configs from the NAS backup (e.g. <code>/volume2/Backups/wiki-migration-*</code> or <code>/volume2/web_packages/mediawiki/</code>).
			# Merge any <code>wfLoadExtension(...)</code> lines into the matching VPS <code>LocalSettings.php</code>.
			# Run <code>maintenance/run.php update --quick</code> in the affected container.

			<code>$wgEnableUploads</code> is enabled so existing files under <code>wiki/images/</code> and <code>werbs-wiki/images/</code> remain usable.

	== Scripts (<code>/var/www/wiki.jb/scripts/</code>) ==		== Scripts (<code>/var/www/wiki.jb/scripts/</code>) ==
Line 77:		Line 91:
	\|-		\|-
	\| Script \|\| Purpose		\| Script \|\| Purpose
			\|-
			\| <code>backup-wikis.sh</code> \|\| Dump both DBs and image trees to <code>backups/YYYY-MM-DD/</code>
	\|-		\|-
	\| <code>fix-logos.sh</code> \|\| Set <code>$wgLogos</code> paths after image changes		\| <code>fix-logos.sh</code> \|\| Set <code>$wgLogos</code> paths after image changes

Josh: Updated documentation from markdown files

2026-05-16T14:07:27Z

Updated documentation from markdown files

← Older revision		Revision as of 14:07, 16 May 2026
Line 71:		Line 71:

	Logos after image restores: <code>bash scripts/fix-logos.sh</code>		Logos after image restores: <code>bash scripts/fix-logos.sh</code>

			== Scripts (<code>/var/www/wiki.jb/scripts/</code>) ==

			{\| class="wikitable"
			\|-
			\| Script \|\| Purpose
			\|-
			\| <code>fix-logos.sh</code> \|\| Set <code>$wgLogos</code> paths after image changes
			\|-
			\| <code>init-db-users.sh</code> \|\| Create/grant <code>wikiuser</code> in MariaDB
			\|-
			\| <code>install-wikis.sh</code> \|\| Fresh MediaWiki install (empty DB only)
			\|}

	== First-time install (empty databases) ==		== First-time install (empty databases) ==

Josh: Uploaded documentation from markdown files

2026-05-16T14:04:36Z

Uploaded documentation from markdown files

New page

Production wikis run on this VPS under <code>/var/www/wiki.jb/</code>.

== Stack ==

{| class="wikitable"
|-
| Service || Container || Public URL || Upstream
|-
| Main wiki || <code>wiki-mediawiki</code> || https://wiki.jb-vpn.uk || <code>127.0.0.1:8010</code>
|-
| Werbs wiki || <code>wiki-werbs-mediawiki</code> || https://werbs-wiki.jb-vpn.uk || <code>127.0.0.1:8011</code>
|-
| Database || <code>wiki-mariadb</code> || (internal) || <code>127.0.0.1:3307</code>
|}

* '''MediaWiki version''': 1.44 (Docker image <code>mediawiki:1.44</code>)

* '''Edge proxy''': Caddy (<code>/etc/caddy/Caddyfile</code>) terminates HTTPS and proxies to the containers

* '''Config on host''': <code>wiki/LocalSettings.php</code>, <code>werbs-wiki/LocalSettings.php</code> (mounted read-only; group <code>www-data</code> must be able to read)

* '''Uploads''': <code>wiki/images/</code>, <code>werbs-wiki/images/</code>

== Daily operations ==

<pre class="lang-bash">
cd /var/www/wiki.jb
docker compose ps
docker compose logs -f wiki
docker compose restart wiki werbs-wiki
</pre>

Upload documentation from the VPS:

<pre class="lang-bash">
python3 /root/wiki_manager.py --upload -y
python3 /root/wiki_manager.py --update-main-page -y
</pre>

Optional uploads without public HTTPS round-trip:

<pre class="lang-bash">
python3 /root/wiki_manager.py --upload -y --wiki-url http://127.0.0.1:8010
</pre>

== Email ==

Outbound mail uses Fastmail SMTP (configured in each <code>LocalSettings.php</code>: <code>$wgSMTP</code>, <code>$wgPasswordSender</code>, <code>$wgEmergencyContact</code>). After editing settings on the host, ensure permissions remain <code>640</code> and group <code>www-data</code>.

== Backups ==

<pre class="lang-bash">
cd /var/www/wiki.jb
source .env
mkdir -p backups
docker compose exec -T mariadb mariadb-dump -uroot -p"$MARIADB_ROOT_PASSWORD" mediawiki \
> backups/mediawiki-$(date +%F).sql
docker compose exec -T mariadb mariadb-dump -uroot -p"$MARIADB_ROOT_PASSWORD" mediawiki_werbs \
> backups/mediawiki_werbs-$(date +%F).sql
tar -czf backups/wiki-images-$(date +%F).tar.gz wiki/images werbs-wiki/images
</pre>

== Maintenance ==

<pre class="lang-bash">
cd /var/www/wiki.jb
source .env
docker compose exec -T wiki php maintenance/run.php update --quick --conf /var/www/html/LocalSettings.php
docker compose exec -T werbs-wiki php maintenance/run.php update --quick --conf /var/www/html/LocalSettings.php
</pre>

Logos after image restores: <code>bash scripts/fix-logos.sh</code>

== First-time install (empty databases) ==

Only needed on a fresh stack without imported content:

<pre class="lang-bash">
cd /var/www/wiki.jb
cp .env.example .env # set passwords
docker compose up -d
bash scripts/init-db-users.sh
bash scripts/install-wikis.sh
</pre>

Admin credentials from <code>.env</code>: <code>WIKI_ADMIN_USER</code> / <code>WIKI_ADMIN_PASSWORD</code> (installer account; production wiki admin is the imported '''Josh''' sysop account).

[[Category:Documentation]]
[[Category:Documentation/Wiki]]