Upgrading NeoWiki

NeoWiki has no releases or version numbers yet, so upgrading means moving to the latest development state.

Upgrading a Docker install

Update the copy of the repository the stack runs from: git pull in it, or re-download it if you took an archive.

Then, from the repository root:

make upgrade

This pulls the latest demo image, restarts the stack on it, runs MediaWiki's updater, and rebuilds every configured backend's projection.

For a stack started with the server profile, run COMPOSE_PROFILES=server make upgrade instead.

If the new version can no longer read your evaluation data, start fresh with make remove && make demo.

Optional: refresh the demo content

make import-demo-data updates the demo pages to the current demo set, the same content as the public demo wiki. It overwrites your edits to those pages (still accessible via page history) and leaves pages you created alone. Then run make rebuild-graph-databases so pages that predate the refresh reach every configured store.

Upgrading a manual install

From the MediaWiki root, update the code, its dependencies, and the frontend bundle:

git -C extensions/NeoWiki pull
composer update

cd extensions/NeoWiki/resources/ext.neowiki
npm ci && npm run build

Then, back at the MediaWiki root:

php maintenance/run.php update --quick
php maintenance/run.php NeoWiki:RebuildGraphDatabases

Rebuild after every upgrade: with no release notes there is no way to tell whether the new version changed the projected shape, and rebuilds are quick at evaluation scale.