Skip to content
FugueDeploy apps from source
Get started

Deploy from source, shared first

Start shared. Move cleanly.

Start from a GitHub repository, a published Docker image, or a local upload on managed shared k3s first. The same app can move onto your own machine later without rebuilding the route or changing the workflow.

Route model

The route is the product.

The fastest path to a public URL should not trap the app in a throwaway setup. In Fugue, the route stays stable while the runtime changes: import the source, go live on shared infrastructure, then migrate onto your own machine when you are ready.

01

Start from a repository, Docker image, or uploaded bundle.

Source location, access mode, and build metadata define the app before the first deploy. GitHub repositories, Docker images, and local uploads all enter the same route-first operating model.

GitHub / Docker image / Upload / Builder
02

Go live on shared infrastructure first.

Shared runtime gets the app public quickly while preserving deploy history, route state, and logs from the first run.

Managed shared runtime / Logs / Route / Deploy ops
03

Attach your own machine later without changing the workflow.

Issue a node key, confirm heartbeat, and move the same app onto your own machine. The route and operating model stay consistent.

Node key / Heartbeat / Migrate / Same control model

Available now

Route, sign-in, and the app already share one system.

Public route

  • Source importGitHub, Docker image, local upload
  • Shared runtimeManaged first path
  • Node key setupAttach a server later
  • Logs and audit trailBuild / Runtime / Operations
  • MigrationShared -> Attached

Sign-in and handoff

  • Sign-in route/auth/sign-in
  • Sign-up route/auth/sign-up
  • Google sign-inLive provider flow
  • Email accessValidation / Failure / Retry
  • App handoffAuth -> App

Quickstart

Verify the public route, then continue to sign in.

export FUGUE_BASE_URL="https://api.fugue.pro"

curl -sS "${FUGUE_BASE_URL}/healthz"

curl -sS "${FUGUE_BASE_URL}/v1/apps/import-github" \
  -H "Authorization: Bearer <tenant-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "repo_url":"https://github.com/example/app",
    "runtime_id":"runtime_managed_shared"
  }'

Sign-in handoff

Sign in without breaking the product flow.

Google sign-in and email sign-up run as full routes with loading, validation, retry, and failure states. The public page hands off directly into the app instead of restarting the journey in a different shell.