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:
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.
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
/aboutpage should list the new software version.