Skip to main content
This page is part of an AI coding agent skill and is written for agents, not humans. For the human-readable Base44 docs, see the developer documentation.

base44 deploy

Deploys all project resources (entities, functions, agents, connectors, and site) to Base44 in a single command.

Syntax

npx base44 deploy [options]

Options

OptionDescription
-y, --yesSkip confirmation prompt

What It Deploys

The command automatically detects and deploys:
  1. Entities - All .jsonc files in base44/entities/
  2. Functions - All functions in base44/functions/
  3. Agents - All agent configurations in base44/agents/
  4. Connectors - All connector configurations in base44/connectors/
  5. Auth Config - Authentication settings from base44/auth/ (if present)
  6. Site - Built files from site.outputDirectory (if configured)

Examples

# Interactive mode - shows what will be deployed and asks for confirmation
npx base44 deploy

# Non-interactive - skip confirmation (for CI/CD or agent use)
npx base44 deploy -y

Typical Workflow

# 1. Make your changes (entities, functions, frontend code)

# 2. Build the frontend (if you have one)
npm run build

# 3. Deploy everything
npx base44 deploy -y

What It Does

  1. Reads project configuration from base44/config.jsonc
  2. Detects available resources (entities, functions, agents, connectors, site)
  3. Shows a summary of what will be deployed
  4. Asks for confirmation (unless -y flag is used)
  5. Deploys all resources in sequence:
    • Pushes entity schemas
    • Deploys functions
    • Pushes agent configurations
    • Pushes connector configurations
    • Pushes auth configuration
    • Uploads site files
  6. Handles OAuth authorization for any new connectors that require it
  7. Displays the dashboard URL and app URL (if site was deployed)

Connector OAuth Flow

If any connectors require authorization after deployment, the CLI will prompt you to open your browser to complete OAuth. In non-interactive environments (CI/CD, no TTY), OAuth prompts are skipped automatically.
Some connectors still require authorization. Run 'base44 connectors push' or open the links above in your browser.

Requirements

  • Must be run from a linked Base44 project directory
  • Must be authenticated (run npx base44 login first)
  • For site deployment, must run npm run build first

Output

After successful deployment:
  • Dashboard: Link to your app’s management dashboard
  • App URL: Your deployed site’s public URL (if site was included)

Notes

  • If no resources are found, the command exits with a message
  • Use individual commands (entities push, functions deploy, connectors push, site deploy) if you only want to deploy specific resources
  • The site must be built before deployment - this command does not run npm run build for you
CommandDescription
base44 entities pushPush only entities
base44 functions deployDeploy only functions
base44 agents pushPush only agents
base44 connectors pushPush only connectors
base44 auth pushPush only auth config
base44 site deployDeploy only the site