voipappz

Command-line tool to install, run, and deploy the VoIPAppz platform. The stack (docker-compose + configs) ships in this repo; the CLI brings it up on the local machine and deploys it to remote hosts over SSH.

Install

curl -fsSL https://raw.githubusercontent.com/voipappz/cli/main/install.sh | sh

Ensures Docker, fetches the CLI + stack into /opt/voipappz, installs the voipappz binary, then runs voipappz bootstrap (docker login → setup → up → health). Runs the app-profile containers on the machine.

Commands

voipappz setup                 generate .env config + secrets
voipappz up [-p app|voip]      start the stack (docker compose)
voipappz down | restart        stop / restart
voipappz status                container states
voipappz health [--api]        health check
voipappz logs                  container logs
voipappz deploy --host <ip> --user <u> --key <key>   provision + deploy over SSH

./.env is auto-loaded; process env wins. Run voipappz --help for the full list.

Configuration

voipappz setup writes .env (config + generated secrets) and config/va.yaml. Both are git-ignored and stay on the machine.

Deploy a remote host

export VA_REGISTRY_PASSWORD=<registry-token>
voipappz deploy --host <ip> --user <user> --key ~/.ssh/<key> --check   # preflight
voipappz deploy --host <ip> --user <user> --key ~/.ssh/<key>           # deploy

Build from source

./build.sh              # static binary via Docker -> bin/voipappz
ARCH=arm64 ./build.sh   # cross-build for aarch64

Docs: https://voipappz.zendesk.com/hc/en-us