Skip to Content
New to Genbox? Check out our Getting Started guide
Commandsconfig

gb config

Inspect and debug Genbox configuration.

Synopsis

gb config [subcommand] [options]

Subcommands

show

Display the resolved configuration:

gb config show [options]

Options:

  • --explain - Show where each value comes from
  • --path <path> - Show specific config path
  • --json - Output as JSON

diff

Compare two profiles:

gb config diff <profile1> <profile2>

Examples

Show Full Config

gb config show

Explain Values

gb config show --explain

Output:

apps.web.port: 3000
  ├─ CLI flag: (not set)
  ├─ Profile 'quick': (not set)
  ├─ genbox.yaml: $detect
  │   └─ detected.yaml: 3000
  │       └─ source: package.json scripts.dev "--port 3000"
  └─ schema default: (none)
  ✓ Final value: 3000

apps.web.type: frontend
  ├─ CLI flag: (not set)
  ├─ Profile 'quick': (not set)
  ├─ genbox.yaml: frontend (explicit)  ◄── User specified
  └─ schema default: (none)
  ✓ Final value: frontend

Show Specific Path

# Show apps configuration
gb config show --path apps
 
# Show specific app
gb config show --path apps.api
 
# Show profiles
gb config show --path profiles

Compare Profiles

gb config diff admin-quick full-stack

Output:

Comparing profiles: admin-quick vs full-stack

  size:
-   small
+   large

  apps:
-   [admin]
+   [admin, api, web]

  database.mode:
-   none
+   copy

  infrastructure:
-   (none)
+   mongodb: local
+   redis: local

JSON Output

gb config show --json
{
  "version": 4,
  "project": {
    "name": "myproject",
    "structure": "monorepo"
  },
  "apps": {
    "admin": {
      "path": "admin/",
      "type": "frontend",
      "port": 3001
    }
  }
}

Value Sources

The --explain flag shows value precedence:

  1. CLI flags - Highest priority
  2. Profile overrides - From selected profile
  3. genbox.yaml explicit - User-defined values
  4. $detect markers - Auto-detected values
  5. Schema defaults - Built-in defaults

Notes

  • Use --explain to debug unexpected values
  • diff helps understand profile differences
  • JSON output useful for scripting

See Also

Last updated on
initprofiles