snailhuddle updating to the latest version of BookWyrm
Upgrading a BookWyrm server, in production (without using Docker).
Log into the server, then go to the directory in which BookWyrm is installed. For example:
ssh ipomoea cd /opt/bookwyrm
Download the new stuff:
git pull
If there are now new requirements, they will need to be installed in order for the migration (in Step 3) to work:
venv/bin/pip3 install -r requirements.txt
Move everything into place:
venv/bin/python3 manage.py migrate venv/bin/python3 manage.py compile_themes venv/bin/python3 manage.py collectstatic --no-input venv/bin/python3 manage.py populate_streams venv/bin/python3 manage.py populate_suggestions
Refreshing the themes, streams, or suggestions is rarely necessary, but on a server with a small user‐base it doesn’t hurt to do so as a matter of course.
- If there have been major changes to
.env.example
, then make adjustments to.env
, as appropriate. Likewise, there may occasionally be important revisions to suggested configuration for nginx or systemd. Restart BookWyrm:
systemctl restart bookwyrm-worker bookwyrm-scheduler bookwyrm
Check the update has worked. Refer to the git log for an idea of what features to look for:
git log --oneline --decorate
The website’s
/about
page should list the new software version.