====== Update Wikis Locally ======

The wiki pages live on Bane at ''/usr/local/jails/wiki-01/usr/local/www/dokuwiki/data/pages/'' and can be synced locally under ''wiki/pages/''.

===== Step 1: Pull wiki pages from Bane =====

<code>
rsync -avz --delete root@bane:/usr/local/jails/wiki-01/usr/local/www/dokuwiki/data/pages/ ./wiki/pages/
</code>

===== Step 2: Preview and edit locally with Docker =====

Start a DokuWiki container with your local pages mounted:

<code>
docker run -d -p 8080:80 \
  -v $(pwd)/wiki/pages:/config/dokuwiki/data/pages \
  --name dokuwiki-preview \
  linuxserver/dokuwiki
</code>

Open http://localhost:8080 in your browser and edit your pages.

When done, stop and remove the container:

<code>
docker stop dokuwiki-preview && docker rm dokuwiki-preview
</code>

===== Step 3: Push changes back to Bane =====

<code>
rsync -avz --delete --chown=www:www ./wiki/pages/ root@bane:/usr/local/jails/wiki-01/usr/local/www/dokuwiki/data/pages/
</code>

The ''--chown=www:www'' flag ensures files land on Bane owned by the ''www'' user that DokuWiki's web server runs as, avoiding permission issues.

===== See Also =====

  * [[infra:start|Infrastructure]]