SillyTavern-hetzner

Deploy SillyTavern to Hetzner Cloud with one command. Creates the server, installs Docker, and starts SillyTavern automatically.

Quick start

0. Use Claude Code (recommended)

The fastest way to deploy — clone the repo and run the setup skill:

git clone https://github.com/tamagochat/SillyTavern-hetzner.git
cd SillyTavern-hetzner
claude /setup

This walks you through getting a Hetzner API token, configures your credentials, and deploys SillyTavern automatically. You're done.

1. Manual setup

git clone https://github.com/tamagochat/SillyTavern-hetzner.git
cd SillyTavern-hetzner

# Configure SillyTavern auth
cp .env.example .env

# Deploy (creates a new Hetzner server)
./deploy.sh --token <your-hetzner-api-token>

Once done, open http://<server-ip>:8000.

Prerequisites

• A Hetzner Cloud account
• An API token (create at: Console → Security → API Tokens)
• curl and jq installed locally

Usage

# Create a new server and deploy
./deploy.sh --token <token>

# Use a specific server type and location
./deploy.sh --token <token> --type cx32 --location nbg1

# Use an SSH key registered in Hetzner (recommended)
./deploy.sh --token <token> --ssh-key my-key

# Deploy to an existing server (skip creation)
./deploy.sh --ip 65.108.123.45

Options

Flag	Default	Description
--token	$HETZNER_API_TOKEN	Hetzner Cloud API token
--name	sillytavern	Server name
--type	cx22	Server type (2 vCPU, 4GB RAM)
--location	fsn1	Datacenter: fsn1, nbg1, hel1, ash, hil
--ssh-key	—	SSH key name registered in Hetzner
--ip	—	Skip creation, deploy to existing server

What it does

1. Creates a Hetzner Cloud server (Ubuntu 24.04)
2. Waits for SSH to be available
3. Installs Docker
4. Uploads Dockerfile, compose file, and config
5. Builds and starts SillyTavern
6. Waits for health check

Update

Re-run the deploy script with --ip:

./deploy.sh --ip <server-ip>

Manual operations

ssh root@<server-ip>
cd /opt/sillytavern

docker compose logs -f sillytavern   # view logs
docker compose restart               # restart
docker compose down                  # stop
docker compose down -v               # stop and delete all data

License

AGPL-3.0 — same as SillyTavern.