Upgrading

Upgrading Bugsink is a simple process. We release new versions of Bugsink regularly, and we recommend that you keep your installation up-to-date to benefit from the latest features and bug fixes.

Depending on how you installed Bugsink, the upgrade process will be different. Here are the steps for each method:

Docker

If you followed the instructions for Docker installation, you can upgrade Bugsink by getting the latest Docker image, stopping the current container, and starting a new container with the new image.

There is no need to run the migrations manually, as the Docker image will automatically run the migrations before starting the server.

# get the latest image
docker pull bugsink/bugsink:latest

# restart the container (syntax depends on how you started the container)
docker ...
# get the latest image
docker pull bugsink/bugsink:latest

# restart the container (syntax depends on how you started the container)
docker ...

Python package

If you followed the instructions for local installation (virtualenv) or the single-server production installation, you can upgrade Bugsink by running the following commands:

Run the following as root to stop the server:

supervisorctl stop gunicorn.service
supervisorctl stop snappea.service
supervisorctl stop gunicorn.service
supervisorctl stop snappea.service

Run the following as the bugsink user to upgrade Bugsink:

. venv/bin/activate
pip install --upgrade bugsink
bugsink-manage migrate
bugsink-manage migrate snappea --database=snappea
. venv/bin/activate
pip install --upgrade bugsink
bugsink-manage migrate
bugsink-manage migrate snappea --database=snappea

Run the following as root to start the server:

supervisorctl start gunicorn.service
supervisorctl start snappea.service
supervisorctl start gunicorn.service
supervisorctl start snappea.service