Skip to content

Getting Started

Vessl turns any bare-metal VPS into your own private Vercel & Railway in under 60 seconds.

Terminal window
curl -fsSL https://get.vessl.dev | sh

This installs the vessld daemon, pulls the required Docker images, and starts the dashboard at http://<your-ip>:8080.

After the install script completes, you’ll see:

✅ Vessl vlatest installed successfully!
📍 Dashboard: http://203.0.113.42:8080
🛠️ Server CLI: vessld --help
💻 Remote CLI: curl -fsSL https://get.vessl.dev/cli | sh

You have two ways to create the admin account:

Open http://<your-server-ip>:8080 in your browser. The first user to register becomes the instance admin.

The install script places vessld at /usr/local/bin/vessld. This is a shell wrapper that runs commands inside the Docker container on your server:

Terminal window
vessld status # Show daemon health and running containers
vessld logs -f # Tail daemon logs
vessld reset-password # Reset admin password
vessld config # View server configuration
vessld config site-name=MyVessl # Update a setting
vessld backup # Create a manual database backup
vessld update # Upgrade to the latest version
vessld downgrade v0.1.0 # Downgrade to a specific version

Install on your local machine to manage your server from anywhere:

Terminal window
curl -fsSL https://get.vessl.dev/cli | sh
vessl login # Connect to your server
vessl project list
vessl deploy <service-id>

Without a domain, Vessl assigns a magic DNS subdomain (like sslip.io or traefik.me) to every service. For production:

  1. Go to Settings → Server Settings.
  2. Set your wildcard domain (e.g. *.vessl.example.com).
  3. Point an A record or CNAME to your server.
  4. Traefik provisions Let’s Encrypt SSL certificates automatically.