Get a demo

Upgrading NeoWiki ​

Before you start, read the release notes of every version after yours: they list any step an upgrade needs beyond the ones below.

Upgrading a Docker install ​

Move the copy of the repository the stack runs from to the version you want: check out its release tag, as in git fetch --tags && git checkout 0.2.0, or follow master with git checkout master && git pull. If you took an archive, unpack the newest release, copy your Docker/.env into it, and carry over any other change you made to the old copy, such as a mounted LocalSettings.php. Both copies run the same stack, so delete the old copy's directory rather than running make remove in it.

Then, from the repository root:

sh
make upgrade

This pulls the demo image of that version, 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 cannot read your pre-0.1 data, start fresh with make remove && make demo, which deletes that data.

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 ​

For a Composer install, run this from the MediaWiki root:

sh
composer update neowiki/neowiki --no-dev -o

This stays on 0.1. To move to 0.2, run COMPOSER=composer.local.json composer require --no-update neowiki/neowiki:^0.2 first, then the command above.

For a branch checkout, update the code, its dependencies, and the frontend bundle from the MediaWiki root:

sh
git -C extensions/NeoWiki pull
composer update

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

Then, either way, run this from the MediaWiki root:

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

If your wiki runs CirrusSearch, also update its search index.