# Upstream sources — n8n

| service | image | source repo | releases / changelog |
|---------|-------|-------------|----------------------|
| app     | n8nio/n8n | https://github.com/n8n-io/n8n | https://github.com/n8n-io/n8n/releases |
| db      | pgautoupgrade/pgautoupgrade | https://github.com/pgautoupgrade/pgautoupgrade | https://hub.docker.com/r/pgautoupgrade/pgautoupgrade/tags |

## Standing notes
- pgautoupgrade uses a non-standard tag scheme (e.g. `17-alpine`, `18-alpine`) mapping to the TARGET
  Postgres major version. `18-alpine` = upgrade-on-start to Postgres 18. The compose.postgres.yml
  controls this image; the main compose.yml uses only `n8nio/n8n` (sqlite mode).
- n8n 2.x: standard rolling upgrade is safe between 2.x versions; DB migrations run automatically on startup.
- The n8n Docker image on Docker Hub uses plain semver tags (e.g. `2.25.3`); no `-stable` suffix needed.
- n8n release notes: https://docs.n8n.io/release-notes/