Skip to content

Hetzner Cloud Deployment

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

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

  1. 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"
  2. Connect to Your Server

    bash
    ssh root@YOUR_SERVER_IP

Method 2: CLI Deployment

  1. Set Up Environment

    bash
    export HCLOUD_TOKEN=your_api_token_here
  2. Install Hetzner Cloud CLI

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

  3. Create Server

    bash
    # 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
  4. Connect to Server

    bash
    ssh root@SERVER_IP

Installing DBConvert Streams

Once your server is ready, install DBConvert Streams:

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

# Start with HTTP
./start.sh

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

Managing Services

Stop Services

bash
./stop.sh

Update Services

bash
./update.sh

Getting Help

DBConvert Streams - event driven replication for databases