Skip to Content
🚀 Faable DeployGet Started

Get Started with Faable Deploy

Faable Deploy is a zero-config CI/CD platform for frontends and backends. Your code runs in Linux containers, gets a public URL with free automatic SSL, and a built-in Web Application Firewall — no infrastructure to manage.

How Faable Deploy is structured

Three concepts model the whole product:

  • Account — your billing and team boundary on Faable.
  • Apps — one app per repo (or one per environment, e.g. staging / production). Each app gets <app>.faable.link plus optional custom domains.
  • Instances — the Linux containers your app runs on. Pick a size from the catalog (bi.xs through bi.2xlarge).

Deploy your first app

  1. In the Faable Dashboard , create a Project and an App.
  2. Open the app and click Link repository. Pick your GitHub org and repo (install the Faable GitHub App if prompted). Faable commits the GitHub Actions workflow to your repo for you.
  3. Push to your release branch. Your app builds and goes live at https://<app>.faable.link.

That’s it — no app_id, API tokens, or YAML to write. Deploys authenticate via OIDC and resolve the app from the linked repository.

[!TIP] If your package.json defines a build script, Faable runs it automatically before deployment. For multi-environment setups (staging/preview/production), custom build commands, or writing the workflow yourself, see GitHub Actions.

Deploy from your laptop with the CLI

For ad-hoc deploys (local testing, debugging) install the CLI and link the repo once:

npm i -g @faable/faable faable login faable link # once per repo — auto-detects the repo, pick the app faable deploy # deploy current repository

[!TIP] Got Request failed with status code 404 on faable deploy? The repository isn’t linked to any app yet. Link it from the dashboard (or run faable link) and deploy again.

What’s next

TopicWhat you’ll learn
GitHub ActionsMulti-environment deploys, custom build scripts, secrets.
RuntimeSupported Node versions, environment variables, the app restart policy.
Custom DomainsMap app.example.com to your app with auto-renewed SSL.
Security & WAFThe built-in Web Application Firewall that ships with every app.
Express guideDeploy an Express backend end-to-end.
CLI referenceEvery flag and command the CLI supports.

Pricing & limits

See Deploy pricing for the instance catalog and bandwidth allowances, and the unified platform pricing for plans and support tiers.

Last updated on