VVCodeSystem configuration
Back to workspace
Product activation

System status

VCode stays healthy when optional infrastructure is absent. Add configuration later and each prepared capability activates without a second implementation pass.

0of 9 capabilities ready
Local Core actions

Capability boundary

Not configured

Start VCode through the Local Core launcher to expose action capability state.

local-core

Local Core

Not configured

Set VICODE_WORKSPACE or start VCode with the Local Core launcher to activate filesystem analysis.

Required environment
VICODE_WORKSPACE
git-cli

Git CLI

Unavailable

Install Git and make the git executable available on the server PATH.

github-app

GitHub App

Not configured

Public GitHub imports still work. Configure the GitHub App values to activate private-repository authorization.

Required environment
GITHUB_APP_CLIENT_IDGITHUB_APP_CLIENT_SECRETVICODE_SESSION_SECRET
github-token-fallback

Server GitHub token fallback

Not configured

The legacy server token fallback is disabled. GitHub App sessions remain preferred.

Required environment
VICODE_ALLOW_SERVER_GITHUB_TOKENGITHUB_TOKEN
database

Database

Not configured

Set DATABASE_URL to activate the Postgres-compatible persistence provider.

Required environment
DATABASE_URL
hosted-persistence

Hosted persistence

Unavailable

Waiting for a valid database configuration before hosted persistence can activate.

Depends on: database

Required environment
DATABASE_URL
redis

Redis / distributed limiter

Not configured

VCode will use its bounded in-process limiter until a complete distributed limiter pair is supplied.

Set one complete environment pair
VICODE_RATE_LIMIT_REST_URLVICODE_RATE_LIMIT_REST_TOKEN
KV_REST_API_URLKV_REST_API_TOKEN
UPSTASH_REDIS_REST_URLUPSTASH_REDIS_REST_TOKEN
ai

AI Assistant

Not configured

Deterministic VCode analysis remains fully available without AI credentials.

Required environment
VICODE_AI_PROVIDERVICODE_AI_MODELVICODE_AI_API_KEY
hosted-auth

Hosted authentication

Unavailable

Waiting for a valid GitHub App configuration before hosted authentication can activate.

Depends on: github-app

Required environment
GITHUB_APP_CLIENT_IDGITHUB_APP_CLIENT_SECRETVICODE_SESSION_SECRET

Online