One command. Your entire server stack, on tap.
Just brew it!

There are two methods:

# Method 1: npm (recommended)
npm install -g @brewnet/cli

# Method 2: Build from source
curl -fsSL https://raw.githubusercontent.com/claude-code-expert/brewnet/main/install.sh | bash

After installation, run brewnet init to start server setup.

• Node.js 20+
• Docker 24+ (auto-installed during brewnet init if missing)
• macOS 12+ or Linux (Ubuntu/Debian/CentOS)
• RAM 2GB minimum (4GB+ recommended)
• Disk 20GB+

No. Currently only macOS and Linux are supported.

# If installed via npm
npm update -g @brewnet/cli

# If installed via curl (re-run the same command)
curl -fsSL https://raw.githubusercontent.com/claude-code-expert/brewnet/main/install.sh | bash

brewnet uninstall            # Interactive uninstall
brewnet uninstall --force    # Uninstall without confirmation
brewnet uninstall --keep-data    # Preserve Docker volumes (DB, etc.)
brewnet uninstall --keep-config  # Keep config files, remove containers only

Removed items: Docker containers, networks, project directories, ~/.brewnet/projects/ metadata

# If installed via npm
npm uninstall -g @brewnet/cli

# If installed via curl
sudo rm /usr/local/bin/brewnet
rm -rf ~/.brewnet/source

brewnet up                  # Start all services
brewnet down                # Stop all services
brewnet down --volumes      # Stop + delete data
brewnet status              # Check overall status
brewnet logs [service]      # View service logs

You can also use brewnet status --json for JSON-formatted output.

brewnet admin   # Automatically opens http://localhost:8088

Use --port 9090 to change the port. Use --foreground for debug mode.

brewnet create-app my-app                    # Interactive selection
brewnet create-app my-app --stack go-gin     # Specify stack
brewnet create-app my-app --database postgres # Specify database

16 stacks supported: Node.js (Express, NestJS, Next.js), Python (FastAPI, Flask, Django), Go (Gin, Echo, Fiber), Rust (Actix-web, Axum), Java (Spring), Kotlin (Spring Boot, Ktor)

brewnet domain connect my-app --domain api.example.com
brewnet domain tunnel status    # Check tunnel status
brewnet domain tunnel restart   # Restart tunnel

A Cloudflare API Token with Zone:Read, DNS:Edit, and Tunnel:Edit permissions is required.

No. All containers are configured with the restart: unless-stopped policy, so they automatically recover once Docker starts after a reboot.

However, if you manually stopped services with brewnet down, they remain stopped after a reboot. On Docker Desktop (macOS), check Settings → General → "Start Docker Desktop when you sign in".

brewnet backup              # Create a backup
brewnet backup --list       # List backups
brewnet restore <backup-id>          # Restore
brewnet restore <backup-id> --force  # Restore without confirmation

Backup location: ~/.brewnet/backups/ (.tar.gz format)

Port conflict: During brewnet init, a warning is shown if ports 80, 443, etc. are in use. Check with lsof -i :80. When creating apps, free ports are automatically assigned.

Docker not installed: brewnet init attempts automatic installation. It uses Homebrew on macOS and the official Docker install script on Linux.

Command errors: Check the install path with which brewnet. If both curl and npm installs exist, conflicts may occur — use only one method.

All config and metadata are stored in ~/.brewnet/. Project directories (docker-compose.yml, app source, etc.) are located at ~/brewnet/<project-name>/.