Cloud Deployment

Run vibespace on a VPS for more resources, persistent uptime, and remote access.

Quick manual setup

Any Linux VPS with root access works. Tested on Hetzner, DigitalOcean, and similar providers.

Recommended specs:

  • 4+ vCPUs (8 recommended)
  • 8GB+ RAM (16 recommended)
  • 40GB+ disk
  • Ubuntu 22.04 or Debian 12
  • Public IPv4 address

Steps

  1. SSH into your VPS
  2. Install vibespace (build from source or copy the binary)
  3. Initialize with bare metal mode:
Terminal window
vibespace init --bare-metal
  1. Start serving:
Terminal window
vibespace serve
  1. Open firewall ports:
Terminal window
# WireGuard tunnel
sudo ufw allow 51820/udp


# Registration API
sudo ufw allow 7781/tcp
  1. Generate a token and connect from your local machine:
Terminal window
# On the VPS
vibespace serve --generate-token


# On your machine
sudo vibespace remote connect <token>

See Remote Mode for detailed connection instructions.

Ansible playbooks

Coming soon. Ansible playbooks for automated provisioning on Hetzner, DigitalOcean, and other providers.

Found an issue? Report it on GitHub →