Back
Documentation

Quickstart

Get your first DevShot server running in under 5 minutes. Deploy a Docker container, get isolated VMs.

Prerequisites

  • -A DevShot account
  • -A Linux host with Docker and KVM support (bare metal, Hetzner, AWS, GCP, etc.)

    • Step 1: Create a Server

    Log in to the Console, go to the Servers tab and click Add Server. Give it a name and click Create.

    You'll get a Docker command like this:

    bash
    docker run -d --restart unless-stopped \
  --device /dev/kvm \
  -e DEVSHOT_TUNNEL_URL=wss://console.devshot.com \
  -e DEVSHOT_SERVER_ID=<your-server-id> \
  -e DEVSHOT_HMAC_SECRET=<your-secret> \
  devshot/agent:latest

    Copy it and run it on your host. The Docker container runs the DevShot agent, which manages isolated VMs using KVM.

    Step 2: Connect

    Once the container starts, the agent connects outbound to the DevShot tunnel. No inbound ports needed, no firewall changes. Your server will show as online in the Console within seconds.

    Step 3: Launch VMs

    VMs boot automatically based on your pool configuration. Go to the VMs tab to see them, or open the Terminal tab to get a full PTY shell inside any VM.

    Step 4: Manage from the Browser

    Use the Console for everything — terminal, remote desktop, storage, networking, firewall, and security. No SSH keys or VPN needed.

    That's it. Docker deploys the agent, the agent runs your VMs.