CLI Reference

Commands

netlaunch login

Authenticate with Google. Opens your browser, stores credentials locally.

netlaunch login

Credentials are saved to ~/.netlaunch/credentials.json. You only need to login once — tokens auto-refresh.

netlaunch logout

Remove stored credentials.

netlaunch logout

netlaunch whoami

Show the currently logged-in user.

netlaunch whoami
# Logged in as: you@gmail.com
#   Your Name
#   UID: abc123

netlaunch deploy

Deploy a static site.

netlaunch deploy --site <name> --file <path> [--key <api-key>]
Flag Short Required Description
--site -s Yes Site name (becomes your .web.app subdomain)
--file -f Yes Path to ZIP archive
--key -k No API key (auto-generated if logged in)
--help -h No Show help
--hosted No Force deploy to NetLaunch hosting (ignore self-hosted config)

Authentication Priority

The CLI resolves API keys in this order:

  1. --key flag
  2. NETLAUNCH_KEY environment variable
  3. Auto-generate from Google login session

If you're logged in, you don't need --key at all.

netlaunch config set

Set Firebase config for self-hosted deployments.

netlaunch config set --file ./service-account.json [--sync]
Flag Required Description
--file / -f Yes Path to service account JSON
--sync No Also save to server for dashboard use

netlaunch config show

Show current Firebase config.

netlaunch config show

netlaunch config remove

Remove local config. Deploys revert to NetLaunch hosting.

netlaunch config remove

Examples

# Login and deploy (simplest)
netlaunch login
netlaunch deploy -s my-app -f ./dist.zip

# Deploy with explicit key
netlaunch deploy -k fk_abc123 -s my-app -f ./dist.zip

# Deploy with env var
export NETLAUNCH_KEY=fk_abc123
netlaunch deploy -s my-app -f ./dist.zip

# Use npx (no global install)
npx netlaunch deploy -s my-app -f ./dist.zip

Credential Storage

Item Location
Credentials ~/.netlaunch/credentials.json
File permissions 0600 (owner only)
Token refresh Automatic (via Firebase)
Session duration Until netlaunch logout