CI / non-interactive deploys

smb is interactive by default — it prompts for confirmations, project setup, credentials, and so on. In CI that’s a problem: there’s no TTY to answer a prompt, so the command would hang or fail with a cryptic terminal error.

Pass the global --ci flag (or set SMB_CI=1, or run under any provider that sets the conventional CI env var) to put smb in non-interactive mode:

• Confirmations resolve to their default instead of asking (e.g. smb --ci logout proceeds without a y/n prompt).
• Any command that genuinely needs interactive input — login, init, signup, account forgot-password, project new/update/delete, and picking a monorepo target — fails fast with a clear, actionable message instead of blocking.

smb --ci deploy            # flag
SMB_CI=1 smb deploy        # env var
CI=true smb deploy         # most CI providers set this automatically

Authenticate ahead of time

Logging in is interactive, so it can’t run under --ci. Provision the token once and make it available to the CI job at ~/.smb/token (production) or ~/.smb-dev/token (dev). Typically you store the token contents in a CI secret and write the file at the start of the job:

- run: |
    mkdir -p ~/.smb
    printf '%s' "${{ secrets.SMB_TOKEN }}" > ~/.smb/token
    chmod 600 ~/.smb/token

Deploys also rsync over SSH using ~/.ssh/id_<user-id>@smbcloud; install that key the same way if your project deploys to a server tier.

Deploying from GitHub Actions

The smbcloudXYZ/smbcloud-deploy-action composite action wraps the steps above: it installs the CLI, writes the token to the right state dir, optionally installs the SSH key, then runs smb --ci deploy.

- uses: smbcloudXYZ/smbcloud-deploy-action@v1
  with:
    token: ${{ secrets.SMB_TOKEN }}

For a monorepo, name the sub-project and pass the SSH inputs that rsync deploys need:

- uses: smbcloudXYZ/smbcloud-deploy-action@v1
  with:
    token: ${{ secrets.SMB_TOKEN }}
    project: docs
    ssh-private-key: ${{ secrets.SMB_SSH_PRIVATE_KEY }}
    ssh-key-name: ${{ secrets.SMB_SSH_KEY_NAME }}
    ssh-known-hosts: ${{ secrets.SMB_SSH_KNOWN_HOSTS }}

The action installs the latest published CLI release, so --ci must exist in that release. Pin the version input if you need a specific CLI version. See the action’s README for the full input reference.

Example: the AircraftsHub monorepo

AircraftsHub  is a Tauri app whose Next.js web app lives in the same repo (web/) as a pnpm workspace. Only the web app deploys to smbCloud; the desktop/mobile app ships to the app stores. Its .smb/config.toml:

name = "aircraftshubweb"
 
[project]
id = 61
kind = "nextjs-ssr"
source = "web"                    # local Next.js app directory (workspace member)
path = "apps/web/aircraftshubweb" # remote runtime directory on the server
package_manager = "pnpm"
pm2_app = "aircraftshub-web"
port = 3022

Because the config pins the project, the source, and the runtime, deploying needs no interaction at all:

smb --ci deploy
# ✔ Build complete.
# App is running ✔
# ✔ Deployment complete.

For a monorepo config with several [[projects]] entries, name the target — --ci mode won’t prompt you to choose:

smb --ci deploy --project aircraftshubweb

Behavior reference