Hetzner Cloud Deployment

This guide covers deploying DBConvert Streams to Hetzner Cloud using Docker.

Video Walkthrough

For a step-by-step video walkthrough of the Hetzner Cloud deployment process, watch the following video:

Watch on YouTube

Prerequisites

A Hetzner Cloud account
SSH client for server access
Domain name (optional, but recommended for production)
Hetzner Cloud API token (for CLI deployment)

Minimum Server Requirements

2GB RAM (4GB recommended for production)
2 CPU cores (3+ cores recommended)
20GB SSD storage

Deployment Methods

You can deploy DBConvert Streams to Hetzner Cloud using either the web console or the CLI tool.

Method 1: Web Console Deployment

Create a Server
- Log in to Hetzner Cloud Console
- Click "Add Server"
- Choose your preferred location
- Select your preferred operating system
- Choose server type based on your needs:
  - Development: CX22 (2 vCPU, 4GB RAM)
  - Production: CX32 (4 vCPU, 8GB RAM)
- Add your SSH key
- Click "Create & Buy Now"
Connect to Your Server
```
ssh root@YOUR_SERVER_IP
```

Method 2: CLI Deployment

Set Up Environment

export HCLOUD_TOKEN=your_api_token_here

Install Hetzner Cloud CLI
Install the Hetzner Cloud CLI by following the official installation guide: https://github.com/hetznercloud/cli#installation

Create Server

# Basic usage
hcloud server create \
    --name dbconvert-streams \
    --type cx22 \
    --location nbg1 \
    --image ubuntu-24.04 \
    --ssh-key ~/.ssh/id_rsa.pub

# Or with different options
hcloud server create \
    --name my-streams \
    --type cx32 \
    --location hel1 \
    --image debian-12 \
    --ssh-key ~/.ssh/id_rsa.pub

Available options:

Server types: cx22 (4 vCPU/8GB), cx32 (8 vCPU/16GB), cx42 (16 vCPU/32GB)
Locations: nbg1 (Nuremberg), fsn1 (Falkenstein), hel1 (Helsinki)
Images: ubuntu-24.04, debian-12, fedora-41

Connect to Server
```
ssh root@SERVER_IP
```

Installing DBConvert Streams

Once your server is ready, install DBConvert Streams:

# Install DBConvert Streams
curl -fsSL https://dbconvert.nyc3.digitaloceanspaces.com/downloads/streams/latest/docker-install.sh | sh

# Change to the installation directory
cd /opt/dbconvert-streams-docker

# Start with HTTP
./start.sh

# Or start with HTTPS (recommended for production)
./start.sh -s

Open http://YOUR_SERVER_IP in your browser. You should see the DBConvert Streams UI. For the full Docker setup guide, see Docker deployment.

Managing Services

Stop Services

./stop.sh

Update Services

./update.sh