Skip to content

Search is only available in production builds. Try building and previewing the site to test it out locally.

Command Reference

Every reactor command accepts global flags (--context, --manifest, --output, --yes, --verbose, --token). Examples below omit them unless relevant.

Terminal window
reactor init <NAME> [--force]

Initialize a new Reactor project with a reactor.toml manifest and starter layout.

FlagDescription
--forceOverwrite existing files in the target directory

Example

Terminal window
reactor init my-app
reactor init my-app --force
Terminal window
reactor project show

Display the active project manifest, resolved paths, and configuration summary.

FlagDescription
(none)No additional flags

Example

Terminal window
reactor project show
reactor -m ./apps/api/reactor.toml project show
Terminal window
reactor build [--out <PATH>]

Build a deployment bundle from the current project manifest.

FlagDescription
--outOutput path for the bundle (default: project-defined)

Example

Terminal window
reactor build
reactor build --out ./dist/bundle.tar.gz
Terminal window
reactor deploy [--bundle <PATH>] [--prebuilt]

Deploy the project to the server configured in the active context.

FlagDescription
--bundlePath to a pre-built bundle to upload
--prebuiltSkip building; use an existing bundle artifact

Example

Terminal window
reactor deploy
reactor build --out ./bundle.tar.gz && reactor deploy --bundle ./bundle.tar.gz
reactor deploy --prebuilt
Terminal window
reactor migrate [--dry-run]

Apply pending database schema migrations for the project.

FlagDescription
--dry-runShow the migration plan without applying changes

Example

Terminal window
reactor migrate --dry-run
reactor migrate
Terminal window
reactor doctor

Run diagnostics on the local project setup and remote server connectivity.

FlagDescription
(none)No additional flags

Example

Terminal window
reactor doctor
reactor -v doctor
Terminal window
reactor version

Print CLI version and build metadata.

FlagDescription
(none)No additional flags

Example

Terminal window
reactor version

Terminal window
reactor context list

List all configured server contexts from ~/.reactor/config.toml.

Example

Terminal window
reactor context list
Terminal window
reactor context add <NAME> --endpoint <URL> [--org <SLUG>] [--token <TOKEN>] [--token-env <VAR>]

Add a new server context.

FlagDescription
--endpointServer endpoint URL (required)
--orgOrganization slug
--tokenAuthentication token (conflicts with --token-env)
--token-envEnvironment variable containing the token (conflicts with --token)

Example

Terminal window
reactor context add cloud --endpoint https://api.reactor.cloud --org acme
reactor context add local --endpoint http://127.0.0.1:8080 --token-env REACTOR_LOCAL_TOKEN
Terminal window
reactor context use <NAME>

Set the default context for subsequent commands.

Example

Terminal window
reactor context use cloud
Terminal window
reactor context show [<NAME>]

Show details for a context. Defaults to the active context when NAME is omitted.

Example

Terminal window
reactor context show
reactor context show cloud
Terminal window
reactor context remove <NAME>

Remove a stored context.

Example

Terminal window
reactor context remove staging
Terminal window
reactor login [--context <NAME>] [--token <TOKEN>] [--browser] [--no-browser] [--bootstrap] [--file-storage]

Authenticate with a Reactor server. Browser PKCE OAuth is recommended for operators.

FlagDescription
--contextContext to authenticate (default: active context)
--tokenStore a token directly (legacy mode)
--browserUse browser-based PKCE OAuth flow
--no-browserUse device code flow instead of browser (requires --browser)
--bootstrapBootstrap as the first platform operator (loopback + admin token)
--file-storageStore tokens in ~/.reactor/tokens.toml instead of OS keychain

Example

Terminal window
reactor login --browser
reactor login --context cloud --browser --no-browser
reactor login --token "$REACTOR_TOKEN"
Terminal window
reactor logout [--context <NAME>]

Remove stored authentication for a context.

FlagDescription
--contextContext to log out from (default: active context)

Example

Terminal window
reactor logout
reactor logout --context cloud
Terminal window
reactor whoami

Show the current authenticated user and organization.

Example

Terminal window
reactor whoami
reactor --output json whoami

Terminal window
reactor functions list

List all functions defined in the project.

Example

Terminal window
reactor functions list
Terminal window
reactor functions show <NAME>

Show details for a single function, including runtime and deployment status.

Example

Terminal window
reactor functions show send-email
Terminal window
reactor functions deploy <NAME> [--source <DIR>]

Deploy or redeploy a function.

FlagDescription
--sourceSource directory (default: manifest path)

Example

Terminal window
reactor functions deploy send-email
reactor functions deploy send-email --source ./functions/send-email
Terminal window
reactor functions rollback <NAME> --to <DEPLOYMENT_ID>

Roll back a function to a previous deployment.

FlagDescription
--toDeployment ID to roll back to (required)

Example

Terminal window
reactor functions rollback send-email --to dep_abc123
Terminal window
reactor functions invoke <NAME> [--data <JSON|@file.json>]

Invoke a function with optional JSON payload.

FlagDescription
--dataRequest body as JSON string or @file.json

Example

Terminal window
reactor functions invoke send-email --data '{"to":"user@example.com"}'
reactor functions invoke send-email --data @payload.json
Terminal window
reactor functions env list <NAME>

List environment variables for a function.

Example

Terminal window
reactor functions env list send-email
Terminal window
reactor functions env get <NAME> <KEY>

Get a single environment variable value.

Example

Terminal window
reactor functions env get send-email SMTP_HOST
Terminal window
reactor functions env set <NAME> <KEY> <VALUE>

Set an environment variable on a function.

Example

Terminal window
reactor functions env set send-email SMTP_HOST smtp.example.com
Terminal window
reactor functions env unset <NAME> <KEY>

Remove an environment variable from a function.

Example

Terminal window
reactor functions env unset send-email SMTP_HOST
Terminal window
reactor functions logs <NAME> [--since <DURATION>] [-f|--follow]

View logs for a function.

FlagDescription
--sinceShow logs since a duration (e.g., 1h, 30m)
-f, --followFollow logs via polling

Example

Terminal window
reactor functions logs send-email --since 1h
reactor functions logs send-email -f

Terminal window
reactor sites list

List all sites in the project.

Example

Terminal window
reactor sites list
Terminal window
reactor sites show <NAME>

Show site details, deployment history, and domain configuration.

Example

Terminal window
reactor sites show web
Terminal window
reactor sites deploy <NAME> [--source <DIR>]

Deploy a site.

FlagDescription
--sourceSource directory (default: manifest path)

Example

Terminal window
reactor sites deploy web
reactor sites deploy web --source ./apps/web/dist
Terminal window
reactor sites promote <NAME> --deployment <DEPLOYMENT_ID>

Promote a specific deployment to production traffic.

FlagDescription
--deploymentDeployment ID to promote (required)

Example

Terminal window
reactor sites promote web --deployment dep_xyz789
Terminal window
reactor sites rollback <NAME>

Roll back a site to the previous deployment.

Example

Terminal window
reactor sites rollback web
Terminal window
reactor sites domains list <NAME>

List custom domains attached to a site.

Example

Terminal window
reactor sites domains list web
Terminal window
reactor sites domains add <NAME> <DOMAIN>

Add a custom domain to a site.

Example

Terminal window
reactor sites domains add web app.example.com
Terminal window
reactor sites domains remove <NAME> <DOMAIN_ID>

Remove a custom domain from a site.

Example

Terminal window
reactor sites domains remove web dom_abc123
Terminal window
reactor sites domains verify <NAME> <DOMAIN_ID>

Trigger DNS verification for a pending domain.

Example

Terminal window
reactor sites domains verify web dom_abc123
Terminal window
reactor sites revalidate <NAME> --path <PATH>

Revalidate ISR cache for a specific path.

FlagDescription
--pathPath to revalidate (required)

Example

Terminal window
reactor sites revalidate web --path /blog/my-post
Terminal window
reactor sites logs <NAME> [--since <DURATION>]

View logs for a site.

FlagDescription
--sinceShow logs since a duration (e.g., 1h, 30m)

Example

Terminal window
reactor sites logs web --since 30m

Terminal window
reactor jobs list

List all background jobs defined in the project.

Example

Terminal window
reactor jobs list
Terminal window
reactor jobs show <NAME>

Show job configuration and schedule details.

Example

Terminal window
reactor jobs show nightly-sync
Terminal window
reactor jobs trigger <NAME> [--data <JSON|@file.json>]

Manually trigger a job run.

FlagDescription
--dataJob payload as JSON string or @file.json

Example

Terminal window
reactor jobs trigger nightly-sync
reactor jobs trigger nightly-sync --data '{"full":true}'
Terminal window
reactor jobs runs <NAME> [--limit <N>]

List recent runs for a job.

FlagDescription
--limitMaximum number of runs to show

Example

Terminal window
reactor jobs runs nightly-sync --limit 10
Terminal window
reactor jobs run <RUN_ID>

Show details for a specific job run.

Example

Terminal window
reactor jobs run run_abc123
Terminal window
reactor jobs dlq list [--job <NAME>]

List dead letter queue entries.

FlagDescription
--jobFilter by job name

Example

Terminal window
reactor jobs dlq list
reactor jobs dlq list --job nightly-sync
Terminal window
reactor jobs dlq replay <ID>

Replay a DLQ entry back into the job queue.

Example

Terminal window
reactor jobs dlq replay dlq_abc123
Terminal window
reactor jobs dlq purge [--job <NAME>]

Purge DLQ entries, optionally filtered by job name.

FlagDescription
--jobFilter purge to a specific job

Example

Terminal window
reactor jobs dlq purge --job nightly-sync
Terminal window
reactor jobs logs <NAME> [--since <DURATION>]

View logs for a job.

FlagDescription
--sinceShow logs since a duration

Example

Terminal window
reactor jobs logs nightly-sync --since 2h

Terminal window
reactor data migrate [--dry-run]

Run data-layer migrations (distinct from schema migrate).

FlagDescription
--dry-runShow migration plan without applying

Example

Terminal window
reactor data migrate --dry-run
reactor data migrate
Terminal window
reactor data inspect <TABLE>

Inspect table schema, row counts, and sample metadata.

Example

Terminal window
reactor data inspect users
Terminal window
reactor data query --sql <SQL> [--params <JSON|@file.json>] [--write]

Execute a SQL query against the project database.

FlagDescription
--sqlSQL query string (required)
--paramsQuery parameters as JSON or @file.json
--writeAllow write operations (INSERT, UPDATE, DELETE)

Example

Terminal window
reactor data query --sql "SELECT id, email FROM users LIMIT 5"
reactor data query --sql "UPDATE users SET active = $1 WHERE id = $2" \
--params '["true","usr_123"]' --write

Terminal window
reactor ai models [-c|--capability <CAPABILITY>]

List available AI models, optionally filtered by capability.

FlagDescription
-c, --capabilityFilter by capability (chat, reasoning, vision, embeddings, etc.)

Example

Terminal window
reactor ai models
reactor ai models --capability chat
Terminal window
reactor ai aliases

List configured model aliases for the project.

Example

Terminal window
reactor ai aliases
Terminal window
reactor ai test <MODEL> [-p|--prompt <TEXT>] [-s|--system <TEXT>] [--stream] [--max-tokens <N>]

Send a test prompt to a model or alias.

FlagDescription
-p, --promptPrompt to send
-s, --systemSystem message
--streamEnable streaming output
--max-tokensMaximum tokens to generate

Example

Terminal window
reactor ai test gpt-4o --prompt "Summarize Reactor in one sentence."
reactor ai test fast-chat --prompt "Hello" --system "You are a helpful assistant." --stream

Organization and identity management for the Reactor auth capability.

Terminal window
reactor auth orgs list

List organizations accessible to the current user.

Example

Terminal window
reactor auth orgs list
Terminal window
reactor auth orgs create --name <NAME> <SLUG>

Create a new organization.

FlagDescription
--nameOrganization display name (required)

Example

Terminal window
reactor auth orgs create --name "Acme Corp" acme
Terminal window
reactor auth orgs show <ORG_ID>

Show organization details.

Example

Terminal window
reactor auth orgs show org_abc123
Terminal window
reactor auth orgs update <ORG_ID> [--name <NAME>] [--slug <SLUG>]

Update organization name or slug.

FlagDescription
--nameNew display name
--slugNew slug

Example

Terminal window
reactor auth orgs update org_abc123 --name "Acme Inc."
Terminal window
reactor auth orgs delete <ORG_ID>

Delete an organization.

Example

Terminal window
reactor auth orgs delete org_abc123
Terminal window
reactor auth members list <ORG_ID>

List members of an organization.

Example

Terminal window
reactor auth members list org_abc123
Terminal window
reactor auth members add <ORG_ID> <USER_ID> [--role <ROLE>]

Add a member to an organization.

FlagDescription
--roleMember role (default: member)

Example

Terminal window
reactor auth members add org_abc123 usr_xyz --role admin
Terminal window
reactor auth members update <ORG_ID> <USER_ID> <ROLE>

Update a member’s role.

Example

Terminal window
reactor auth members update org_abc123 usr_xyz member
Terminal window
reactor auth members remove <ORG_ID> <USER_ID>

Remove a member from an organization.

Example

Terminal window
reactor auth members remove org_abc123 usr_xyz
Terminal window
reactor auth keys list <ORG_ID>

List API keys for an organization.

Example

Terminal window
reactor auth keys list org_abc123
Terminal window
reactor auth keys create <ORG_ID> <NAME>

Create a new API key.

Example

Terminal window
reactor auth keys create org_abc123 "CI deploy key"
Terminal window
reactor auth keys revoke <KEY_ID>

Revoke an API key.

Example

Terminal window
reactor auth keys revoke key_abc123
Terminal window
reactor auth invitations list <ORG_ID>

List pending invitations for an organization.

Example

Terminal window
reactor auth invitations list org_abc123
Terminal window
reactor auth invitations create <ORG_ID> <EMAIL> [--role <ROLE>]

Invite a user by email.

FlagDescription
--roleRole for the invited user (default: member)

Example

Terminal window
reactor auth invitations create org_abc123 dev@example.com --role admin
Terminal window
reactor auth invitations revoke <INVITATION_ID>

Revoke a pending invitation.

Example

Terminal window
reactor auth invitations revoke inv_abc123

Manage connectors, webhook receivers, schema drift, and SDK codegen.

Terminal window
reactor connect catalog list

List available connector types in the catalog.

Example

Terminal window
reactor connect catalog list
Terminal window
reactor connect catalog show <CONNECTOR_TYPE>

Show connector type details, actions, and configuration schema.

Example

Terminal window
reactor connect catalog show stripe
reactor connect catalog show slack
Terminal window
reactor connect instances list

List connector instances in the project.

Example

Terminal window
reactor connect instances list
Terminal window
reactor connect instances create <CONNECTOR_TYPE> --name <NAME> [--config <JSON|@file.json>]

Create a new connector instance.

FlagDescription
--nameInstance name (required)
--configConfiguration JSON or @file.json

Example

Terminal window
reactor connect instances create stripe --name billing --config @stripe-config.json
Terminal window
reactor connect instances show <INSTANCE_ID>

Show instance details and status.

Example

Terminal window
reactor connect instances show inst_abc123
Terminal window
reactor connect instances update <INSTANCE_ID> [--name <NAME>] [--config <JSON|@file.json>]

Update instance name or configuration.

FlagDescription
--nameNew instance name
--configUpdated configuration JSON or @file.json

Example

Terminal window
reactor connect instances update inst_abc123 --config @updated-config.json
Terminal window
reactor connect instances delete <INSTANCE_ID> [--yes]

Delete a connector instance.

FlagDescription
--yesSkip confirmation prompt

Example

Terminal window
reactor connect instances delete inst_abc123 --yes
Terminal window
reactor connect instances check <INSTANCE_ID>

Test instance credentials and connectivity.

Example

Terminal window
reactor connect instances check inst_abc123
Terminal window
reactor connect instances credentials <INSTANCE_ID> <CREDENTIALS>

Set credentials for an instance. Value may be JSON, @file.json, or - for stdin.

Example

Terminal window
reactor connect instances credentials inst_abc123 @creds.json
echo '{"api_key":"sk_live_..."}' | reactor connect instances credentials inst_abc123 -
Terminal window
reactor connect action <INSTANCE_ID> <ACTION> [--input <JSON|@file.json|->] [--dry-run] [--idempotency-key <KEY>]

Invoke an action on a connector instance.

FlagDescription
--inputAction input JSON, @file.json, or - for stdin
--dry-runRun in dry-run/sandbox mode
--idempotency-keyIdempotency key for the action

Example

Terminal window
reactor connect action inst_abc123 createCustomer \
--input '{"email":"user@example.com"}'
reactor connect action inst_abc123 postMessage --input @message.json --dry-run
Terminal window
reactor connect receivers list

List webhook receivers.

Example

Terminal window
reactor connect receivers list
Terminal window
reactor connect receivers create --name <NAME> --target-type <TYPE> --target <TARGET> [--filter <EXPR>]

Create a webhook receiver.

FlagDescription
--nameReceiver name (required)
--target-typeTarget type: job, stream, action, or function (required)
--targetTarget name or connection ID (required)
--filterOptional filter expression

Example

Terminal window
reactor connect receivers create \
--name stripe-webhooks \
--target-type job \
--target process-stripe-event
Terminal window
reactor connect receivers show <RECEIVER_ID>

Show receiver details and endpoint URL.

Example

Terminal window
reactor connect receivers show rcv_abc123
Terminal window
reactor connect receivers delete <RECEIVER_ID> [--yes]

Delete a webhook receiver.

FlagDescription
--yesSkip confirmation prompt

Example

Terminal window
reactor connect receivers delete rcv_abc123 --yes
Terminal window
reactor connect receivers rotate <RECEIVER_ID> [--grace-seconds <SECONDS>]

Rotate a receiver’s signing token.

FlagDescription
--grace-secondsGrace period for the old token (default: 300)

Example

Terminal window
reactor connect receivers rotate rcv_abc123 --grace-seconds 600
Terminal window
reactor connect drift list [--connection <NAME>] [--all]

List schema drift events.

FlagDescription
--connectionFilter by connection name
--allInclude all statuses, not just pending

Example

Terminal window
reactor connect drift list
reactor connect drift list --connection stripe-billing --all
Terminal window
reactor connect drift approve <DRIFT_ID> [--reason <TEXT>] [--yes]

Approve a pending schema drift event.

FlagDescription
--reasonReason for approval
--yesSkip confirmation prompt

Example

Terminal window
reactor connect drift approve drift_abc123 --reason "Field added by vendor API v2"
Terminal window
reactor connect drift reject <DRIFT_ID> [--reason <TEXT>] [--yes]

Reject a pending schema drift event.

FlagDescription
--reasonReason for rejection
--yesSkip confirmation prompt

Example

Terminal window
reactor connect drift reject drift_abc123 --reason "Unexpected breaking change"
Terminal window
reactor connect codegen --instance <NAME> [--output <DIR>] [--format <FORMAT>]

Generate TypeScript SDK types (or JSON Schema) for a connector instance.

FlagDescription
--instanceInstance name to generate types for (required)
--outputOutput directory (default: ./generated)
--formatOutput format: typescript or json-schema (default: typescript)

Example

Terminal window
reactor connect codegen --instance billing
reactor connect codegen --instance billing --output ./src/generated --format json-schema
Terminal window
reactor connect auth <INSTANCE_ID> [--no-browser] [--port <PORT>]

Authenticate with an OAuth connector (requires connect-oauth feature).

FlagDescription
--no-browserPrint OAuth URL instead of opening a browser
--portPort for OAuth callback server (default: 9876)

Example

Terminal window
reactor connect auth inst_abc123
reactor connect auth inst_abc123 --no-browser --port 9876

Terminal window
reactor vault list

List secret keys stored in the project vault (values are not shown).

Example

Terminal window
reactor vault list
Terminal window
reactor vault get <KEY>

Retrieve a secret value.

Example

Terminal window
reactor vault get DATABASE_URL
Terminal window
reactor vault set <KEY> <VALUE>

Set a secret value. VALUE may be a literal, @file.json, or - for stdin.

Example

Terminal window
reactor vault set API_KEY sk_live_abc123
reactor vault set SERVICE_ACCOUNT @sa.json
Terminal window
reactor vault unset <KEY>

Delete a secret from the vault.

Example

Terminal window
reactor vault unset OLD_API_KEY
Terminal window
reactor vault rotate <KEY_NAME>

Rotate a transit encryption key.

Example

Terminal window
reactor vault rotate app-data-key

Reactor.cloud control plane operations. Cloud domain commands accept --cf-token to override CF_API_TOKEN.

Terminal window
reactor cloud projects create <NAME> [--region <REGION>] [--subdomain <LABEL>] [--cf-token <TOKEN>]

Create a new cloud project.

FlagDescription
--regionDeployment region
--subdomainProvision a *.reactor.cloud subdomain (label or FQDN)
--cf-tokenCloudflare API token (overrides CF_API_TOKEN)

Example

Terminal window
reactor cloud projects create my-app --region us-east --subdomain my-app
Terminal window
reactor cloud projects list [--owner <UUID>] [--limit <N>] [--offset <N>]

List cloud projects.

FlagDescription
--ownerFilter by owner user ID
--limitMaximum results (default: 50)
--offsetPagination offset (default: 0)

Example

Terminal window
reactor cloud projects list --limit 20
Terminal window
reactor cloud projects show <PROJECT_REF>

Show project details.

Example

Terminal window
reactor cloud projects show prj_abc123
Terminal window
reactor cloud projects delete <PROJECT_REF> [--yes]

Delete a cloud project.

FlagDescription
--yesSkip confirmation prompt

Example

Terminal window
reactor cloud projects delete prj_abc123 --yes
Terminal window
reactor cloud keys list <PROJECT_REF>

List API keys for a cloud project.

Example

Terminal window
reactor cloud keys list prj_abc123
Terminal window
reactor cloud keys create <PROJECT_REF> --kind <KIND>

Create a new API key.

FlagDescription
--kindKey kind: anon or service (required)

Example

Terminal window
reactor cloud keys create prj_abc123 --kind service
Terminal window
reactor cloud keys rotate <PROJECT_REF> <KEY_ID>

Rotate an API key.

Example

Terminal window
reactor cloud keys rotate prj_abc123 key_abc123
Terminal window
reactor cloud keys revoke <PROJECT_REF> <KEY_ID>

Revoke an API key.

Example

Terminal window
reactor cloud keys revoke prj_abc123 key_abc123
Terminal window
reactor cloud members list <PROJECT_REF>

List members of a cloud project.

Example

Terminal window
reactor cloud members list prj_abc123
Terminal window
reactor cloud members add <PROJECT_REF> <USER_ID> [--role <ROLE>]

Add a member to a cloud project.

FlagDescription
--roleMember role: admin or member (default: member)

Example

Terminal window
reactor cloud members add prj_abc123 usr_xyz --role admin
Terminal window
reactor cloud members remove <PROJECT_REF> <USER_ID>

Remove a member from a cloud project.

Example

Terminal window
reactor cloud members remove prj_abc123 usr_xyz
Terminal window
reactor cloud domains add <NAME> [--target <HOSTNAME>] [--cf-token <TOKEN>]

Add a subdomain to reactor.cloud (creates Cloudflare CNAME).

FlagDescription
--targetCNAME target hostname (default: rc-shared-1-edge.fly.dev)
--cf-tokenCloudflare API token (overrides CF_API_TOKEN)

Example

Terminal window
reactor cloud domains add my-app
reactor cloud domains add my-app.reactor.cloud --target rc-shared-1-edge.fly.dev
Terminal window
reactor cloud domains list [--cf-token <TOKEN>]

List reactor.cloud subdomains.

FlagDescription
--cf-tokenCloudflare API token (overrides CF_API_TOKEN)

Example

Terminal window
reactor cloud domains list
Terminal window
reactor cloud domains remove <NAME> [--yes] [--cf-token <TOKEN>]

Remove a subdomain from reactor.cloud.

FlagDescription
--yesSkip confirmation prompt
--cf-tokenCloudflare API token (overrides CF_API_TOKEN)

Example

Terminal window
reactor cloud domains remove my-app --yes
Terminal window
reactor cloud audit <PROJECT_REF> [--limit <N>]

View the audit log for a cloud project.

FlagDescription
--limitMaximum entries to show (default: 50)

Example

Terminal window
reactor cloud audit prj_abc123 --limit 100

Local development server commands. Require the dev feature in the CLI build.

Terminal window
reactor dev [--host <HOST>] [--port <PORT>] [--db <URL>] [--ephemeral] [--admin-token <TOKEN>] [--context <NAME>]

Start a foreground local Reactor server.

FlagDescription
--hostHost to bind to (default: 127.0.0.1)
--portPort to listen on (default: 8080)
--dbDatabase URL (conflicts with --ephemeral)
--ephemeralUse docker-managed ephemeral Postgres
--admin-tokenAdmin token for the server
--contextContext name for the local server

Example

Terminal window
reactor dev
reactor dev --ephemeral --port 9090
reactor dev --db postgres://localhost:5432/reactor_dev
Terminal window
reactor up [--host <HOST>] [--port <PORT>] [--db <URL>] [--ephemeral] [--admin-token <TOKEN>] [--context <NAME>] [--force]

Start a detached local Reactor server in the background.

FlagDescription
--hostHost to bind to (default: 127.0.0.1)
--portPort to listen on (default: 8080)
--dbDatabase URL (conflicts with --ephemeral)
--ephemeralUse docker-managed ephemeral Postgres
--admin-tokenAdmin token for the server
--contextContext name for the local server
--forceForce restart if already running

Example

Terminal window
reactor up --ephemeral
reactor up --context local-dev --force
Terminal window
reactor down [--context <NAME>]

Stop a detached local server.

FlagDescription
--contextContext for the detached server

Example

Terminal window
reactor down
reactor down --context local-dev
Terminal window
reactor status [--context <NAME>] [--all]

Show status of local development servers.

FlagDescription
--contextContext for a specific detached server
--allShow status of all servers

Example

Terminal window
reactor status
reactor status --all
reactor status --context local-dev

Terminal window
reactor inspect <KIND> <NAME>

Inspect a resource by kind and name or ID.

Supported kinds: function, site, job, org, member, key, bucket, domain.

Example

Terminal window
reactor inspect function send-email
reactor inspect site web
reactor inspect org org_abc123
Terminal window
reactor logs <CAPABILITY> [<NAME>] [--since <DURATION>] [-f|--follow]

View logs across capabilities.

Argument / FlagDescription
CAPABILITYCapability name: functions, sites, or jobs
NAMEOptional resource name
--sinceShow logs since a duration
-f, --followFollow logs via polling

Example

Terminal window
reactor logs functions send-email --since 1h
reactor logs sites web
reactor logs jobs -f
Terminal window
reactor types generate [-o|--output <PATH>]

Generate TypeScript types from the database schema.

FlagDescription
-o, --outputOutput file path (default: ./database.types.ts)

Example

Terminal window
reactor types generate
reactor types generate --output ./src/database.types.ts