Skip to content

Environment Variables

All environment variables recognized by NexusCore CLI and NexusIDE.

General

VariableDescriptionDefault
NEXUS_CONFIGPath to config file~/.nexuscore/config.yaml
NEXUS_VERBOSEEnable verbose output (1 or 0)0
NEXUS_NO_COLORDisable colored output (1 or 0)0
NEXUS_LOG_LEVELLog level (debug, info, warn, error)info

Model Configuration

VariableDescriptionDefault
NEXUS_MODEL_PROVIDERDefault model provider name
NEXUS_API_KEYAPI key for the default provider
NEXUS_MODELDefault model name
NEXUS_BASE_URLCustom API base URL for the default provider
OPENAI_API_KEYOpenAI API key (used when provider type is openai)
ANTHROPIC_API_KEYAnthropic API key (used when provider type is anthropic)
GOOGLE_API_KEYGoogle AI API key (used when provider type is google)

Authentication

VariableDescriptionDefault
NEXUS_AUTH_URLAuth service URLhttps://api.nexus-suite.dev
NEXUS_TOKENJWT token for CI/automation (bypasses interactive login)

TIP

Use NEXUS_TOKEN in CI/CD pipelines where interactive login isn't possible. Generate a long-lived token from the Portal at nexus-suite.dev/account.

Sync

VariableDescriptionDefault
NEXUS_SYNC_ENABLEDEnable encrypted sync (1 or 0)0

NexusAPI Server Variables

These variables are used by the NexusAPI backend service, not by the CLI or IDE.

VariableDescription
DATABASE_URLPostgreSQL connection string
REDIS_URLRedis connection string
JWT_PRIVATE_KEYRS256 private key (PEM format)
JWT_PUBLIC_KEYRS256 public key (PEM format)
JWT_ISSUERJWT issuer claim (https://api.nexus-suite.dev)
STRIPE_SECRET_KEYStripe secret API key
STRIPE_WEBHOOK_SECRETStripe webhook signing secret
STRIPE_PRICE_PRO_MONTHLYStripe price ID for Pro monthly
STRIPE_PRICE_PRO_ANNUALStripe price ID for Pro annual
STRIPE_PRICE_STUDIO_MONTHLYStripe price ID for Studio monthly
STRIPE_PRICE_STUDIO_ANNUALStripe price ID for Studio annual
GOOGLE_CLIENT_IDGoogle OAuth client ID
GOOGLE_CLIENT_SECRETGoogle OAuth client secret
GITHUB_CLIENT_IDGitHub OAuth client ID
GITHUB_CLIENT_SECRETGitHub OAuth client secret
RESEND_API_KEYResend email API key
EMAIL_FROMSender address for transactional emails
TELEGRAM_BOT_TOKENTelegram Bot API token
R2_ACCOUNT_IDCloudflare R2 account ID
R2_ACCESS_KEY_IDR2 access key
R2_SECRET_ACCESS_KEYR2 secret key
R2_BUCKET_SYNCR2 bucket for sync blobs
R2_BUCKET_SKILLSR2 bucket for skill packages
NODE_ENVNode environment (production, development)
PORTAPI server port
CORS_ORIGINSAllowed CORS origins

Precedence

Environment variables take precedence over config file values but are overridden by command-line flags:

  1. Command-line flags (highest priority)
  2. Environment variables
  3. Project-level config (.nexuscore/config.yaml)
  4. User-level config (~/.nexuscore/config.yaml)
  5. Built-in defaults (lowest priority)

Released under the MIT License.