Skip to content

Search docs

Search the Skiffly documentation

Quick start

From a GitHub repository to a running app with a public domain in a few minutes, using the dashboard, the CLI or an AI agent through MCP.

You need a GitHub account and an app that listens on the port in $PORT (or on a fixed port you tell Skiffly about). Public repositories work right away; for private ones install the Skiffly GitHub App when asked.

  1. Sign in with GitHub at app.skiffly.dev. A personal workspace is created with a small trial credit.
  2. New project, then New service → GitHub repo: pick a repository and a branch. Railpack detects the stack; a Dockerfile in the root is used instead when present. The first deployment starts immediately.
  3. Watch the build in the Deployments tab. When the status turns to SUCCESS, open the service's Settings → Networking → Generate domain to get https://<name>-<id>.skiffly.cloud.
  4. Need a database? New service → Template → PostgreSQL. It gets a volume and DATABASE_URL; in your app's variables add DATABASE_URL=${{Postgres.DATABASE_URL}} and redeploy.
  5. Every push to the branch deploys again. Turn on PR previews in project settings to get a preview environment per pull request.

Next steps#

Custom domainOne CNAME, one TXT record, TLS within a minute.Variables & referencesShare secrets between services without copying them.Config as codeDescribe the project in skiffly.ts and skiffly config apply.BillingPlans, usage rates, top-ups and what happens when the balance runs out.