Self-host Svix on a VPS
A webhooks sending service with retries, signatures, a message log and an HTTP API, backed by Postgres and Redis. Create applications and send events through the API with a token signed by your JWT secret.
levelrail-cli templates install svix --name my-svixSpecification
- Status
- Listed
- Category
- Developer Tools
- Services
- db, redis, svix
- Ports
- 8071
- Volumes
- 2
- Memory
- about 384 MiB
- arm64
- unknown
- amd64
- unknown
- Settings to fill in
- none
- License
- Permissive license, MIT
- Listing
- Community template
About Svix
A webhooks sending service with retries, signatures, a message log and an HTTP API, backed by Postgres and Redis. Create applications and send events through the API with a token signed by your JWT secret.
What it deploys
Svix runs as 3 services in a single Compose app, listening on port 8071, with 2 named volume mounts.
| Service | Image | Tag | Ports | Volumes |
|---|---|---|---|---|
| db | postgres | 17.11-alpine | none | pgdata -> /var/lib/postgresql/data |
| redis | redis | 7.4.7-alpine | none | redis_data -> /data |
| svix | svix/svix-server | v1.105.0 | 8071 | none |
Before you install
- CPU architecture. arm64 unknown. The scan could not read a manifest or the tag is chosen at install time. This is not a claim either way.
- Listed. It is in the catalog. Back up the data volume before changing an image tag.
Settings and environment
You do not have to fill in anything. 3 secrets are generated at deploy and stored encrypted. Values are never shown here.
| Service | Variable | Value |
|---|---|---|
| db | POSTGRES_DB | Preset by the template |
| db | POSTGRES_PASSWORD | Generated at deploy |
| db | POSTGRES_USER | Preset by the template |
| svix | SVIX_DB_DSN | Generated at deploy |
| svix | SVIX_JWT_SECRET | Generated at deploy |
| svix | SVIX_REDIS_DSN | Preset by the template |
| svix | WAIT_FOR | Preset by the template |
First run
- Create an API token with the svix-server jwt generate command inside the container, then call the API at the published port.
Install Svix on a VPS
-
Install Levelrail on a fresh VPS
Run this as root on a Linux server (amd64 or arm64) with ports 80 and 443 reachable. The installer prints a setup link.
curl -fsSL https://levelrail.com/install.sh | sudo sh -
Sign in
Open the setup link, choose a password, then log the CLI in. The CLI install command is
curl -fsSL https://levelrail.com/install-cli.sh | shif the machine does not have it. See Getting started.levelrail-cli login --device -
Read the template
Shows the entry, including its full compose.yaml.
levelrail-cli templates get svix -
Install it
This template has an install form, so the CLI fills each setting from --env, a generated secret or its default.
levelrail-cli templates install svix --name my-svixTo put a service behind a domain at install, add
--domain SERVICE=HOST:levelrail-cli templates install svix --name my-svix --domain db=svix.example.com
Without a domain the app gets an sslip.io address. You can also deploy it from the dashboard: Apps, New app, Browse templates, then Svix.
Docs and upstream
More in Developer Tools
- Swagger UIRenders an OpenAPI description as interactive API documentation you can try from the browser. It is static, has no login and no database.
- StrapiAn open-source headless CMS with a customizable admin panel and a REST/GraphQL content API.
- TermixA web-based SSH, RDP, and VNC terminal manager for organizing and connecting to every server from one dashboard.
- Sonatype Nexus RepositoryA universal artifact repository for Maven, npm, Docker, PyPI, and more, with proxying and caching.
- SonarQube CommunityContinuous code quality and security analysis across 30+ languages, with quality gates for every pull request.
- TolgeeA localization management platform where developers and translators work in one shared UI.