VIBE Params

VIBE module has 13 config parameters, grouped into: common params, Code-Server params, JupyterLab params, and Claude Code params.

Parameter Overview

Common Parameters

vibe_data

VIBE module working directory, default working path for all components.

• Type: path
• Level: H/I (Host/Instance)
• Default: /fs

Used for:

• Code-Server default open directory
• JupyterLab Notebook root directory
• Claude Code working directory
• Store CLAUDE.md and AGENTS.md context files

Recommend using JuiceFS mount point for distributed storage and PITR capability.

vibe_data: /fs              # Default, JuiceFS mount point
vibe_data: /home/dev/work   # Custom working directory

Code-Server Parameters

code_enabled

Whether to enable Code-Server on this node.

• Type: bool
• Level: H/I
• Default: true

code_enabled: true   # Enabled (default)
code_enabled: false  # Disabled

code_port

Code-Server listen port, binds to localhost only.

• Type: port
• Level: H/I
• Default: 8443

External access via Nginx reverse proxy, no need to expose this port directly.

code_port: 8443   # Default port
code_port: 9443   # Custom port

code_data

Code-Server user data directory, stores extensions, user settings, etc.

• Type: path
• Level: H/I
• Default: /data/code

Directory structure:

/data/code/
├── code-server/
│   ├── config.yaml      # Config file
│   ├── extensions/      # Installed extensions
│   └── User/
│       └── settings.json # User settings
└── ...

code_data: /data/code      # Default path
code_data: /home/dev/code  # Custom path

code_password

Code-Server login password.

• Type: string
• Level: H/I
• Default: Code.Server

code_password: 'Code.Server'     # Default (change it!)
code_password: 'MySecretPass!'   # Custom password

code_gallery

Code-Server extension marketplace type.

• Type: enum
• Level: H/I
• Default: openvsx
• Options: openvsx, microsoft

China mainland auto-uses Tsinghua mirror.

code_gallery: openvsx    # Open VSX (default)
code_gallery: microsoft  # Microsoft marketplace

JupyterLab Parameters

jupyter_enabled

Whether to enable JupyterLab on this node.

• Type: bool
• Level: H/I
• Default: true

jupyter_enabled: true   # Enabled (default)
jupyter_enabled: false  # Disabled

jupyter_port

JupyterLab listen port.

• Type: port
• Level: H/I
• Default: 8888

JupyterLab binds to 0.0.0.0, but typically accessed via Nginx reverse proxy.

jupyter_port: 8888   # Default port
jupyter_port: 8899   # Custom port

jupyter_data

JupyterLab data directory, stores config files and kernel info.

• Type: path
• Level: H/I
• Default: /data/jupyter

Directory structure:

/data/jupyter/
├── jupyter_config.py   # JupyterLab config
└── kernels/            # Jupyter kernels

jupyter_data: /data/jupyter      # Default path
jupyter_data: /home/dev/jupyter  # Custom path

jupyter_password

JupyterLab login Token.

• Type: string
• Level: H/I
• Default: Jupyter.Lab

jupyter_password: 'Jupyter.Lab'   # Default (change it!)
jupyter_password: 'MySecretToken' # Custom Token

jupyter_venv

Python virtual environment path for JupyterLab.

• Type: path
• Level: H/I
• Default: /data/venv

Directory structure:

/data/venv/
└── bin/
    ├── python
    ├── pip
    └── jupyter

jupyter_venv: /data/venv          # Default path
jupyter_venv: /home/dev/.venv     # Custom path

Claude Code Parameters

claude_enabled

Whether to enable Claude Code CLI configuration on this node.

• Type: bool
• Level: H/I
• Default: true

claude_enabled: true   # Enabled (default)
claude_enabled: false  # Disabled

claude_env

Extra environment variables for Claude Code, used for API Key etc.

• Type: dict
• Level: H/I
• Default: {}

Common environment variables:

# Configure API Key
claude_env:
  ANTHROPIC_API_KEY: sk-ant-xxx-your-api-key

# Configure custom API endpoint
claude_env:
  ANTHROPIC_API_KEY: sk-ant-xxx
  ANTHROPIC_BASE_URL: https://api.example.com

Parameter Level Reference

VIBE module params are all H/I level, defined at host or instance level. Different hosts can have different values:

all:
  children:
    infra:
      hosts:
        10.10.10.10:
          code_enabled: true
          code_password: 'Password1'
        10.10.10.11:
          code_enabled: true
          code_password: 'Password2'

Default Values Summary

# VIBE common params
vibe_data: /fs

# Code-Server params
code_enabled: true
code_port: 8443
code_data: /data/code
code_password: 'Code.Server'
code_gallery: openvsx

# JupyterLab params
jupyter_enabled: true
jupyter_port: 8888
jupyter_data: /data/jupyter
jupyter_password: 'Jupyter.Lab'
jupyter_venv: /data/venv

# Claude Code params
claude_enabled: true
claude_env: {}