devdesk/etc/env

# DevDesk defaults, shipped by the package. Don't edit: put your changes in
# /etc/devdesk/env.local (same KEY=value format, read after this file), so
# package upgrades never prompt about this file.
# Read by systemd (EnvironmentFile=) and by the devdesk scripts, the same way:
# plain KEY=value lines, values taken literally (no $VAR, no $(…)), optionally
# in quotes. No inline comments. Other lines are ignored with a warning.
# The ttyd credential lives in /etc/devdesk/secret.env (generated on install).

# Port ttyd listens on (NPM proxies dev.lotusguild.org here).
DEVDESK_PORT=7681

# Optional interface name or IP for ttyd to bind; empty = all interfaces.
DEVDESK_BIND=

# Sessions map to project directories under this root; the default session uses the root itself.
DEVDESK_PROJECTS_ROOT=/root/code
DEVDESK_DEFAULT_SESSION=main

# Where sessions that are not a project folder start (e.g. ops sessions); empty = projects root.
DEVDESK_DEFAULT_DIR=

# Gitea for the Repo/CI panel. Public repos need no token; for private ones put a
# read:repository token in /etc/devdesk/gitea-token (mode 600).
DEVDESK_GITEA_URL=https://code.lotusguild.org
DEVDESK_GITEA_ALIASES=10.10.10.63

# Grafana for the Ops Alerts panel (firing/pending alert rules). A Viewer
# service-account token goes in DEVDESK_GRAFANA_TOKEN_FILE (mode 600).
DEVDESK_GRAFANA_URL=http://10.10.10.49:3000
DEVDESK_GRAFANA_PUBLIC_URL=https://dashboard.lotusguild.org
DEVDESK_GRAFANA_TOKEN_FILE=/etc/devdesk/grafana-token

# Proxmox nodes to ask where guests run (`devdesk guests`, and the CT/VM and node
# shown on each alert and given to Claude by "Ask Claude"). Space-separated SSH
# hosts; the first that answers gives the cluster view, then every online node is
# asked for its containers' IPs, by node name. Needs root SSH keys to the nodes.
# Empty = off.
DEVDESK_PVE_NODES=

# Claude Code binary and extra arguments for every session.
CLAUDE_BIN=/root/.local/bin/claude
CLAUDE_ARGS=

# Where DevDesk is reached in a browser; used for links in Matrix notifications.
DEVDESK_PUBLIC_URL=https://dev.lotusguild.org

# "Claude needs you" in Matrix when a session waits and no tab or SSH client is
# attached: put a hookshot webhook URL in this file (mode 600). No file = off.
# Only real requests (a permission prompt, a question), never Claude's idle
# reminder, and never while a DevDesk tab is in view.
# DEVDESK_MATRIX_DELAY: seconds the wait must last before posting.
# DEVDESK_MATRIX_QUIET: at most one message per session in this many seconds.
DEVDESK_MATRIX_WEBHOOK_FILE=/etc/devdesk/matrix-webhook
DEVDESK_MATRIX_DELAY=60
DEVDESK_MATRIX_QUIET=600
# DEVDESK_USAGE_WARN: post to the same room once per 5-hour window when plan usage
# passes this percent while no DevDesk tab is in view (devdesk#45).
DEVDESK_USAGE_WARN=90

# 0 turns off the guard that makes Claude ask before destructive commands
# (pct/zfs/ceph destroy, rm -r /…, force pushes, reboots). Extra rules:
# /etc/devdesk/guard.local, one "regex<TAB>reason" per line.
DEVDESK_GUARD=1

# Remote Control default for new sessions (1 = on: continue them from the Claude app;
# Anthropic then stores the transcript to sync devices). Settings in the web UI
# overrides this, and each session can choose its own (devdesk#61).
DEVDESK_REMOTE_CONTROL=0