Install

One-liner

curl -fsSL voodu.clowk.in/install | bash

This drops the voodu binary into /usr/local/bin/voodu and prints the version. Re-run any time to upgrade.

Voodu hosts the installer directly on Cloudflare Pages — every push to main rebuilds the docs site and re-ships the canonical install script verbatim. Auto-detects client on macOS, server on Linux.

Verify

voodu version
# voodu 0.9.2 (commit abcd123)

Manual install

The canonical installer lives in the repo. Run it directly:

curl -fsSL https://raw.githubusercontent.com/thadeu/clowk-voodu/main/install | bash

It auto-detects mode by OS — client on macOS (CLI only), server on Linux (CLI + voodu-controller + Docker + systemd unit + default plugins). Force the mode explicitly:

# Laptop / CLI only
curl -fsSL https://raw.githubusercontent.com/thadeu/clowk-voodu/main/install | bash -s -- --client

# Production host (CLI + controller + Docker + plugins)
curl -fsSL https://raw.githubusercontent.com/thadeu/clowk-voodu/main/install | bash -s -- --server

Env knobs

Variable	Default	Effect
`VERSION`	latest GitHub release	Pin a specific release tag.
`VOODU_INSTALL_REPO`	`thadeu/clowk-voodu`	Source repo (for forks / mirrors).
`VOODU_ROOT`	`/opt/voodu`	Server state dir.
`VOODU_HTTP_ADDR`	`0.0.0.0:8686`	Controller HTTP bind.
`VOODU_DEFAULT_PLUGINS`	`thadeu/voodu-caddy`	Space-separated plugins to seed on first boot.
`SKIP_DOCKER=1`	—	Skip Docker install (server mode only).
`SKIP_PLUGINS=1`	—	Skip default plugin install (offline boxes).

Example — pin a version and skip Docker (already provisioned):

VERSION=0.9.2 SKIP_DOCKER=1 \
  curl -fsSL https://raw.githubusercontent.com/thadeu/clowk-voodu/main/install | bash -s -- --server

Requirements

Laptop: any POSIX shell. macOS or Linux. Windows works via WSL.
Remote host: Linux with SSH access. The first voodu remote setup installs Docker, Caddy, and the voodu controller.
Local toolchain: none required. Voodu does not need Docker on your laptop — builds happen on the remote.

Next steps

Bootstrap a remote — one-time host setup.
Ship your first app — app "demo" "web" { ... } then voodu apply.