Documentation
Environment Variables
Configure Oxmgr daemon behavior via environment variables. Set these before starting the daemon.
Daemon Configuration
| Variable | Description |
|---|---|
| OXMGR_HOME | Custom Oxmgr data directory. Default: ~/.local/share/oxmgr (Linux/macOS), %LOCALAPPDATA%\oxmgr (Windows). Process logs and state files are stored here. |
| OXMGR_DAEMON_ADDR | Custom daemon bind address (host:port). CLI communicates with the daemon over this address. |
| OXMGR_API_ADDR | HTTP API / webhook bind address. Default: high localhost port. Set this to expose the pull webhook and metrics endpoint. |
| OXMGR_LOG_MAX_SIZE_MB | Log rotation size threshold in MB. When a process log exceeds this size, it is rotated. |
| OXMGR_LOG_MAX_FILES | Number of rotated log files to retain per process. |
| OXMGR_LOG_MAX_DAYS | Rotated log retention period in days. Older files are deleted automatically. |
Usage
Set these before the daemon starts. If you installed Oxmgr as a system service, add them to the service environment:
Shell / .bashrc / .zshrc
export OXMGR_HOME=/data/oxmgr
export OXMGR_LOG_MAX_SIZE_MB=100
systemd service override
# /etc/systemd/system/oxmgr.service.d/env.conf
[Service]
Environment=OXMGR_HOME=/data/oxmgr
Environment=OXMGR_LOG_MAX_SIZE_MB=100
Note on OXMGR_API_ADDR
The API address is used for the pull webhook (POST /pull/<name>) and
Prometheus metrics (GET /metrics). By default it binds to a high-numbered
localhost port. Set OXMGR_API_ADDR=0.0.0.0:8080 to expose it externally —
but always protect it with a reverse proxy or firewall rule.
See Git & Webhooks for security guidance.
Still have questions?
Open an issue or browse the source on GitHub.