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

Four 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).
CI — GitHub Actions is the recommended way to deploy; the CLI is available for ad-hoc deploys.

Prerequisites

Create an account on the Faable Dashboard .
Create a Project and an App inside it. Note the App name.
Have a Git repository ready (Node.js, Go, Python, static frontend — anything that runs in a container).

Deploy your first app (recommended: GitHub Actions)

Faable Deploy integrates with GitHub Actions via OpenID Connect — no API tokens to rotate. Drop a workflow file in your repo and every push to your release branch deploys automatically.

Create .github/workflows/deploy.yaml:


name: Deploy to Faable
on:
  push:
    branches: [main]
permissions:
  id-token: write          # required for OIDC auth against Faable
  contents: write
jobs:
  deploy:
    runs-on: ubuntu-latest
    timeout-minutes: 10
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-node@v6
      - run: npm ci
      - run: npx @faable/faable@latest deploy

Commit and push to main. When the workflow finishes:

🌍 Your app is live at https://<app_name>.faable.link.

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

Alternative — deploy from your laptop with the CLI

For ad-hoc deploys (local testing, debugging) install the CLI:


npm i -g @faable/faable
faable login
faable deploy <app_name>

Both paths produce the same result and can coexist on the same app.

What’s next

Topic	What you’ll learn
GitHub Actions	Multi-environment deploys, custom build scripts, secrets.
Runtime	Supported Node versions, environment variables, the app restart policy.
Custom Domains	Map `app.example.com` to your app with auto-renewed SSL.
Security & WAF	The built-in Web Application Firewall that ships with every app.
Express guide	Deploy an Express backend end-to-end.
CLI reference	Every 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.