Image Tags

Hassette ships as a Docker image hosted at ghcr.io/nodejsmith/hassette (GitHub Container Registry). Each tag combines a Hassette version and a Python version — for example, v0.39.0-py3.13.

The tag goes on the image: line of your docker-compose.yml from Docker Setup.

Which Tag to Use

For production, use a tag with a specific version number:

services:
  hassette:
    image: ghcr.io/nodejsmith/hassette:v0.39.0-py3.13

A version-specific tag never changes — Docker downloads the same code every time.

For development, use latest-py3.13:

services:
  hassette:
    image: ghcr.io/nodejsmith/hassette:latest-py3.13

latest-py3.* tags track the most recent stable release. New features arrive on the next pull.

Python 3.11, 3.12, 3.13, and 3.14 are all supported. Replace py3.13 in the tag with your preferred version.

Updating

Run this in the directory containing your docker-compose.yml:

docker compose pull && docker compose up -d

pull fetches the new image. up -d restarts the container with it. Docker prints the download progress, then a Started line — check the logs afterward to confirm Hassette reconnected.