VIBE on Pigsty v5.0

Module: VIBE

Mon, 01 Jan 0001 00:00:00 +0000

The VIBE module provides a browser-based dev environment with Code-Server, JupyterLab, Node.js, Claude Code, and Codex CLI, and can work with JUICE shared storage and PGSQL database capabilities.

VIBE depends on NODE and INFRA:

NODE provides base software and Python uv environment
INFRA provides Nginx reverse proxy, Grafana and portal entry

Components

Component	Description	Local Port	Access Path
Code-Server	VS Code in browser	8443	`/code/`
JupyterLab	Interactive notebooks	8888	`/jupyter/`
Node.js	Runtime and npm	-	CLI
Claude Code	CLI + observability config	-	CLI / Grafana
Codex CLI	CLI installation; configuration is not managed	-	CLI

Notes:

Configuration

Mon, 01 Jan 0001 00:00:00 +0000

VIBE supports enabling components on demand and exposes services via a unified workspace and Nginx portal.

Overview

Component	Enable Param	Default	Description
Code-Server	`code_enabled`	Enabled	VS Code in browser
JupyterLab	`jupyter_enabled`	Disabled	Notebook / terminal / editor
Node.js	`nodejs_enabled`	Enabled	Node.js runtime and npm
Claude Code	`claude_enabled`	Enabled	CLI installation, config, and observability
Codex CLI	`codex_enabled`	Enabled	CLI installation only; configuration is not managed

Note: module default is jupyter_enabled: false, while conf/vibe.yml explicitly sets it to true.

Parameters

Mon, 01 Jan 0001 00:00:00 +0000

VIBE module has 18 parameters, grouped as:

Common
Code-Server
JupyterLab
Node.js
Claude Code
Codex CLI

Overview

Parameter	Type	Level	Default	Description
`vibe_data`	`path`	`C`	`/fs`	Workspace dir
`code_enabled`	`bool`	`C`	`true`	Enable Code-Server
`code_port`	`port`	`C`	`8443`	Code-Server port
`code_data`	`path`	`C`	`/data/code`	Code-Server data dir
`code_password`	`string`	`C`	`Vibe.Coding`	Code-Server password
`code_gallery`	`enum`	`C`	`openvsx`	Extension marketplace
`jupyter_enabled`	`bool`	`C`	`false`	Enable JupyterLab
`jupyter_port`	`port`	`C`	`8888`	JupyterLab port
`jupyter_data`	`path`	`C`	`/data/jupyter`	JupyterLab data dir
`jupyter_password`	`string`	`C`	`Vibe.Coding`	JupyterLab token
`jupyter_venv`	`path`	`C`	`/data/venv`	Python venv path
`nodejs_enabled`	`bool`	`C`	`true`	Enable Node.js
`nodejs_registry`	`url`	`C`	`''`	npm registry mirror
`npm_packages`	`string[]`	`C`	`[]`	Additional global npm packages
`claude_enabled`	`bool`	`C`	`true`	Install and configure Claude Code
`claude_package`	`string`	`C`	`@anthropic-ai/claude-code`	Claude Code npm package
`claude_env`	`dict`	`C`	`{}`	Claude env vars
`codex_enabled`	`bool`	`C`	`true`	Install Codex CLI

Default Parameters

Defined in roles/vibe/defaults/main.yml:

Playbook

Mon, 01 Jan 0001 00:00:00 +0000

VIBE provides the vibe.yml playbook to deploy Code-Server, JupyterLab, Node.js, Claude Code, and Codex CLI.

vibe.yml includes only node_id and vibe roles, it does not include node/infra. Run deploy.yml first, or explicitly run node.yml and infra.yml.

`vibe.yml`

vibe.yml:

- name: VIBE
  hosts: all
  become: true
  gather_facts: no
  roles:
    - { role: node_id, tags: id }
    - { role: vibe,    tags: vibe }

Task Structure

vibe
├── vibe_dir          # create workspace and context files
├── code              # Code-Server
│   ├── code_install
│   ├── code_dir
│   ├── code_config
│   └── code_launch
├── jupyter           # JupyterLab
│   ├── jupyter_install
│   ├── jupyter_dir
│   ├── jupyter_config
│   └── jupyter_launch
├── nodejs            # Node.js runtime and additional npm packages
│   ├── nodejs_install
│   ├── nodejs_config
│   └── nodejs_pkg
├── codex             # Codex CLI
│   └── codex_install
└── claude            # Claude Code
    ├── claude_install
    └── claude_config

Notes:

Administration

Mon, 01 Jan 0001 00:00:00 +0000

Service Management

systemctl status code-server
systemctl restart code-server
systemctl status jupyter
systemctl restart jupyter

Logs:

journalctl -u code-server -f
journalctl -u jupyter -f

Workspace and Context

vibe_dir creates these under vibe_data:

AGENTS.md: Context file rendered from the role template
CLAUDE.md: Symlink to AGENTS.md

Default locations (adjustable via vibe_data):

Monitoring

Mon, 01 Jan 0001 00:00:00 +0000

VIBE monitoring mainly focuses on Claude Code OpenTelemetry data. Code-Server and JupyterLab do not expose Prometheus metrics; use systemd and logs for health checks.

Claude Code Observability

VIBE writes default OpenTelemetry env vars into ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_METRICS_PROTOCOL": "http/protobuf",
    "OTEL_EXPORTER_OTLP_LOGS_PROTOCOL": "http/protobuf",
    "OTEL_EXPORTER_OTLP_METRICS_ENDPOINT": "http://127.0.0.1:8428/opentelemetry/v1/metrics",
    "OTEL_EXPORTER_OTLP_LOGS_ENDPOINT": "http://127.0.0.1:9428/insert/opentelemetry/v1/logs",
    "OTEL_RESOURCE_ATTRIBUTES": "ip=<host>,job=claude"
  }
}

claude_env is merged with the defaults, and can be used for API keys or custom endpoints.

FAQ

Mon, 01 Jan 0001 00:00:00 +0000

Deployment

code-server package not found

Ensure NODE and repo config are in place:

yum repolist    # EL
apt-cache policy   # Debian/Ubuntu, read-only inspection
./infra.yml -l infra -t repo --check

JupyterLab installation failed

jupyter_venv must exist:

uv venv /data/venv
./vibe.yml -l <host> -t jupyter --check
./vibe.yml -l <host> -t jupyter

Access

Cannot access `/code/` or `/jupyter/`

Check service status
Check port listening
Check Nginx config

systemctl status code-server
systemctl status jupyter
ss -tlnp | grep 8443
ss -tlnp | grep 8888
nginx -t

WebSocket connection fails

Ensure Nginx enables WebSocket (default is enabled). If using custom infra_portal, set websocket: true.

VIBE on Pigsty v5.0

Module: VIBE

Components

Configuration

Overview

Parameters

Overview

Default Parameters

Playbook

vibe.yml

Task Structure

Administration

Service Management

Workspace and Context

Monitoring

Claude Code Observability

FAQ

Deployment

code-server package not found

JupyterLab installation failed

Access

Cannot access /code/ or /jupyter/

WebSocket connection fails

`vibe.yml`

Cannot access `/code/` or `/jupyter/`