Install on Linux
Native install for a VPS or cloud VM without Docker. No compilation required.
Quick start
curl -fsSL https://raw.githubusercontent.com/bunnyandcloud/bunny/main/scripts/install-release.sh | sh
bunny configure
bunny run
Pin a version:
BUNNY_VERSION=v0.1.0 curl -fsSL .../install-release.sh | sh
Supported: linux-amd64 and linux-arm64. Binaries are published on each GitHub release tag.
The script downloads a release tarball from GitHub Releases, installs runtime dependencies, and puts bunny on your PATH.
Prerequisites
The install script runs install-runtime.sh which installs:
- tmux, Node.js 20+, Neovim
- Browser stack (Xvfb, x11vnc, websockify, noVNC, Playwright Chromium) unless
--minimal
Skip browser tab:
BUNNY_MINIMAL=1 curl -fsSL .../install-release.sh | sh
systemd
sudo cp infra/systemd/bunny-agent.service /etc/systemd/system/
sudo systemctl enable --now bunny-agent
The unit expects bunny at /usr/local/bin/bunny.
SSH tunnel mode
bunny run --host 127.0.0.1 --port 7681
ssh -L 7681:127.0.0.1:7681 user@server
Expose on public IP
Less secure — use only with firewall rules and MFA:
bunny run --host 0.0.0.0 --port 7681
Alternative: Docker on Linux
You can also run the pre-built Docker image on a Linux VPS — same result, often simpler upgrades.
Developer install from source
See Developer install if you need a git checkout.