# Self-host Gotify

> A simple push notification server with a REST API and web UI, for sending messages to your devices.

- Page: https://levelrail.com/templates/gotify/
- JSON: https://levelrail.com/templates/gotify.json
- Category: Communication
- Licence: MIT (Permissive license)
- Source: https://github.com/gotify/server
- Upstream docs: https://gotify.net/docs/

## Requirements
- Memory: about 128 MiB
- amd64: published, arm64: tested
- Needs configuration before start: no
- Pinned image tag: 2.6.1

## Services

| Service | Image | Tag | Ports | Volumes |
| --- | --- | --- | --- | --- |
| gotify | gotify/server | 2.6.1 | 80 | gotify_data -> /app/data |

## Environment

| Service | Variable | Kind |
| --- | --- | --- |
| gotify | GOTIFY_DEFAULTUSER_NAME | preset |
| gotify | GOTIFY_DEFAULTUSER_PASS | generated |
| gotify | TZ | preset |

## Deploy

### CLI

```bash
levelrail-cli templates deploy gotify --name my-gotify
```

### API

```bash
curl -X POST -H "Authorization: Bearer $TOKEN" \
  https://levelrail.example.com/api/v1/service-templates/gotify/deploy
```

Create a token in the dashboard first. This one-click route deploys it as a trial app you can keep or remove.

## Questions

### Can I deploy Gotify on Dokploy or Dokku?

The services and pinned images on this page can be run on any Docker host. The public Dokploy templates list has an entry with the id gotify for this app, so check that entry as well. Dokku deploys container images with its own commands, so the pinned image gotify/server:2.6.1 is what you deploy there.

Self-host Gotify, Gotify docker compose file, deploy Gotify on a VPS: this page lists the pinned image, ports, volumes and the commands for each.
