Skip to content

Quick deploy

The shortest path to a running Waveshift deployment.

Page in progress

The full walkthrough is being captured against the v0.5 wsctl TUI. The high-level flow is here; the detailed screenshots and tips are coming soon.

Prerequisites

  • AWS CLI authenticated (SSO or static keys).
  • wsctl on your PATH.
  • An identity account string issued to you by Blackfire Technology.
  • A clean working directory.

wsctl creates a private Route 53 hosted zone for the Console and Kasm; you don't need a public domain.

The flow

mkdir mycompany-waveshift && cd mycompany-waveshift
aws sso login --profile mycompany-dev   # or `aws configure`
wsctl

wsctl with no arguments launches the bubbletea TUI. The TUI walks you through:

  1. AWS profile — picked from ~/.aws/config / ~/.aws/credentials.
  2. Configure → Infrastructure:
    • Region — the AWS region the orchestrator runs in.
    • Private domain — the name to use for the private Route 53 hosted zone the Console and Kasm resolve under (default waveshift.internal).
    • Identity account — the federation string Blackfire issued you.
  3. Configure → Waveshift — defaults are fine.
  4. Configure → Kasm — optional; skip it (or untick Enabled) if Workspaces isn't licensed.
  5. Deploy → All — ~10–15 minutes for a clean run.

When it finishes, the status panel shows the deployment as deployed, with the Console's subdomain and domain.

After the deploy

  1. Connect to the WireGuard network (Hub, Node, or direct WireGuard config from an Infrastructure Server), open https://console.<your-domain> (default https://console.waveshift.internal), and sign in with the default credentials (admin / admin123). Change the password immediately from Profile → Change password.
  2. Apply your platform licence (System → Platform licence).
  3. Enable at least one region (System → Regions).
  4. Create users (Users administration).

Adding hardware Sites and Hubs happens through the TUI's Node Sites screen as a follow-up step — full walkthrough coming with screenshots.

Default credentials

Service URL Username Password
Web Console https://console.waveshift.internal (default) admin admin123
Kasm Workspaces https://workspaces.waveshift.internal (default) admin Waveshift2025!
Hub router http://10.34.0.1 root Waveshift2025!

Change defaults on first login

All three ship with publicly-documented passwords. Change them as soon as you finish setup.

Where to next