VxCloud Tutorials

Hands-on, step-by-step walkthroughs that mirror the real wizards in your dashboard. Every guide is self-contained with copy-paste commands and live UI previews — most take 10–20 minutes from a clean workspace.

12 tutorials7 learning tracksBeginner → Advanced

Getting started1

🖥️Beginner

Provision your first node (InstaNodeBox)

Wire an existing VM — or spin up a fresh one on AWS, GCP, Azure, Linode, Hetzner and more — into your VxCloud workspace, register it as a node, and confirm it is healthy.

5 minStart

Frontend2

▲Beginner

Deploy a Next.js app from GitHub

Clone a Next.js repo from GitHub, build it with Node 20, and serve it in production behind Nginx — with a live progress stream and Git-token auth sealed in Vault.

10 minStart

⚛️Beginner

Deploy a React.js SPA

Static-build a React app, ship the dist/ tree to your node, and serve it over HTTPS with cache-control headers and client-side routing that survives a hard refresh.

10 minStart

Backend3

🟢Beginner

Deploy a Node.js (Express / Fastify / NestJS) API

Pick your framework, clone from Git, install dependencies, and run the API under process supervision so it restarts on crash and survives a reboot.

12 minStart

⚡Intermediate

Deploy a FastAPI service with managed Postgres

Ship a FastAPI app, provision a MetalDB Postgres alongside it, and wire DATABASE_URL through Vault so the credential never lives in your code or the deploy form.

15 minStart

🐹Intermediate

Deploy a Go service from a private repo

Build a single static Go binary with go.mod resolution, authenticate to a private repo via Vault, and run it over SSH — including the trailing-whitespace gotcha that bites everyone once.

10 minStart

Containers1

🐳Intermediate

Custom Service — write any docker-compose.yml

Deploy any Compose stack to your node. Start from one of 20+ built-in templates (Postgres, Redis, Kafka, ELK, n8n, Mattermost, Vault…) or paste your own YAML in a full Monaco editor.

10 minStart

Databases1

🐘Intermediate

Provision MetalDB — self-hosted Postgres

Stand up a managed Postgres on your own VM with an optional read replica, scheduled backups, and pgAdmin — and have the connection string land in Vault automatically.

15 minStart

CI/CD2

🚦Intermediate

Set up a CI/CD pipeline with blue-green deploys

Define a multi-stage pipeline, gate production behind a manual approval, and switch traffic blue-green so a bad release is one click away from rollback.

20 minStart

🤖Intermediate

Run vxcli inside GitHub Actions

Authenticate vxcli with a scoped xc_* key, dry-run deploys on pull requests, apply on merge to main, and pull Terraform state for review jobs — all headless.

15 minStart

Security2

🔐Advanced

Lock down a workspace with SSO & RBAC

Connect Okta or Azure AD over SAML, map IdP groups to VxCloud roles, enforce MFA on production paths, and confirm every privileged action lands in the audit stream.

25 minStart

📡Advanced

Stream audit events to Splunk / Datadog

Pull the audit event stream, deduplicate with its hash chain, and forward to your SIEM — with a copy-paste worker in plain Node.js.

20 minStart

Need a tutorial we don't have?

We add walkthroughs as we ship features. If there's a workflow you'd like covered, tell us — most requests turn into a published guide within a week.

Browse the docs Request a tutorial