Skip to content

Add CLI deployment scripts for existing servers #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
justin-russell wants to merge 9 commits into
base: main
Choose a base branch
from
Open

Add CLI deployment scripts for existing servers #1

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
3fcda9d
Fix turbopack
thebalaa Feb 2, 2026
5e670a5
Add deploy.yml back
thebalaa Feb 3, 2026
76e77e6
Delete .github/workflows directory
thebalaa Feb 3, 2026
39e8700
Add CLI deployment scripts for deploying to existing servers
justin-russell Feb 3, 2026
f8564a2
Update README with CLI deployment documentation
justin-russell Feb 3, 2026
7e0e7c9
Add automatic setup script with Python 3.12+ detection
justin-russell Feb 3, 2026
3e235f0
Implement one-command deployment with auto-setup and direct IP support
justin-russell Feb 3, 2026
55b4d1e
Merge main branch - add LICENSE and update community links
justin-russell Feb 3, 2026
ee12c88
Organize CLI scripts into cli/ directory for better structure
justin-russell Feb 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions .env.example
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Hetzner Cloud API Token
# Get from: https://console.hetzner.cloud/ → Security → API Tokens
HCLOUD_TOKEN=your-hetzner-api-token-here

# SSH Public Key (optional, will use ~/.ssh/id_ed25519.pub if not set)
# SSH_PUBLIC_KEY=ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA... user@host
75 changes: 0 additions & 75 deletions .github/workflows/deploy.yml
View file
Open in desktop

This file was deleted.

48 changes: 48 additions & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
# Environment and secrets
.env

# SSH keys (auto-generated, should not be committed)
hetzner_key
hetzner_key.pub
ssh-keys/

# Generated files
finland-instance-ip.txt
available-server-types.txt

# Python virtualenv
venv/
__pycache__/
*.py[cod]
*$py.class
*.so
.Python
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
parts/
sdist/
var/
wheels/
*.egg-info/
.installed.cfg
*.egg

# Ansible
*.retry
.ansible/

# IDE
.vscode/
.idea/
*.swp
*.swo
*~
.DS_Store

# Logs
*.log
deployment-logs/
6 changes: 6 additions & 0 deletions .gitmodules
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
[submodule "clawdbot-ansible"]
path = clawdbot-ansible
url = https://github.com/openclaw/clawdbot-ansible.git
[submodule "openclaw"]
path = openclaw
url = https://github.com/openclaw/openclaw.git
1 change: 1 addition & 0 deletions CNAME
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
roboclaw.ai
85 changes: 85 additions & 0 deletions HETZNER_SETUP.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
# Hetzner Finland Instance Setup

Quick guide to create a server in Helsinki, Finland using Ansible.

## Prerequisites

1. **Hetzner Cloud Account**
- Sign up at https://console.hetzner.cloud/
- Create a project

2. **API Token**
- Go to your project → Security → API Tokens
- Generate a new token with Read & Write permissions
- Save it securely

3. **SSH Key**
- Generate if you don't have one: `ssh-keygen -t ed25519 -C "your@email.com"`
- Your public key is at `~/.ssh/id_ed25519.pub`

## Installation

```bash
# Install Ansible (if not already installed)
pip3 install ansible

# Install Hetzner collection
ansible-galaxy collection install -r hetzner-requirements.yml
```

## Usage

```bash
# 1. Make sure your .env file has HCLOUD_TOKEN set
# (See .env.example for format)

# 2. Run the playbook (credentials loaded from .env automatically)
./cli/cli/run-hetzner.sh

# 3. Connect to your server (IP saved to finland-instance-ip.txt)
ssh root@$(cat finland-instance-ip.txt)
```

**Note**: Your `.env` file is automatically added to `.gitignore` to prevent token leaks.

## Customization

Edit `hetzner-finland.yml` to change:
- `server_type`: Instance size (cx22, cx32, cx42, etc.)
- `server_name`: Your server's name
- `image`: OS image (ubuntu-24.04, debian-12, rocky-9, etc.)

## Pricing

Default `cx22` instance costs ~€5.28/month:
- 2 vCPU
- 4GB RAM
- 40GB NVMe SSD
- 20TB traffic

Smaller options:
- `cx11`: €4.15/month (1 vCPU, 2GB RAM)
- `cx21`: €4.71/month (2 vCPU, 4GB RAM)

## Teardown

```bash
# List all servers
source .env && source venv/bin/activate && \
ansible-playbook hetzner-teardown.yml --tags list

# Delete server (with confirmation prompt)
source .env && source venv/bin/activate && \
ansible-playbook hetzner-teardown.yml --tags delete

# Delete specific server
source .env && source venv/bin/activate && \
ansible-playbook hetzner-teardown.yml --tags delete -e server_name=my-server

# Delete server and SSH key
source .env && source venv/bin/activate && \
ansible-playbook hetzner-teardown.yml --tags delete -e delete_ssh_key=true

# Clean up local files
rm hetzner_key hetzner_key.pub finland-instance-ip.txt
```
Loading