Waymaker
Waymaker Host

Getting Started with Waymaker Host

Learn about Getting Started with Waymaker Host in WaymakerOS.

Quick StartFirst App

Deploy your first app in 5 minutes. This guide walks you through the fastest path from zero to live.

Prerequisites

  • A Waymaker account with an organization
  • A GitHub account with a repository to deploy
  • The Waymaker GitHub App installed (we'll do this in step 1)

Step 1: Connect GitHub

Before you can deploy apps, connect your GitHub account to Waymaker:

  1. Go to Host in Commander
  2. Click Connect GitHub
  3. Authorize the Waymaker GitHub App
  4. Select which repositories to grant access to

This creates a secure connection between your GitHub repos and the Waymaker build pipeline.

Step 2: Create Your App

Using the CLI

Set your API key (API Keys), then create the app with one command — name, repository, branch and framework. The command is in the command reference in the developer docs.

Using Claude Desktop

"Create a new app called my-first-app from my GitHub repo https://github.com/yourorg/your-repo"

What Happens

  1. Waymaker provisions your app on Waymaker's global edge network
  2. Links it to your GitHub repository
  3. Auto-detects your framework and build settings
  4. Triggers the first deployment

Step 3: Watch Your Build

Your app is now building. Check status:

This can also be done from the Waymaker CLI — see the command reference in the developer docs.

Or ask Claude: "What's the status of my app my-first-app?"

The first build typically takes 1-3 minutes depending on your project size.

Step 4: Visit Your App

Once deployed, your app is live at:

https://<slug>.waymakerapp.com

Every app gets a free *.waymakerapp.com subdomain with automatic SSL.

Step 5: Set Up a Custom Domain (Optional)

Want your own domain? Three steps:

  1. Connect your domain in Host — you get the DNS records to add (a CNAME for the app, a TXT record proving ownership, and a CNAME for the certificate)
  2. Add those records at your DNS provider
  3. Verify — Host checks the records and issues the certificate

Each step is also one CLI command — see the command reference in the developer docs.

SSL is issued and auto-renews after verification. For root domains, apex setup, and Cloudflare-hosted DNS, see Custom Domains.

What's Next