buque/docs/QUICK_START.md

Buque Docker Compose Manager

Quick Links

• Installation
• Quick Start
• Commands
• Examples
• Configuration

Installation

Requirements

• Go 1.21+
• Docker 20.10+
• Docker Compose V2

Install from source

git clone https://github.com/manalejandro/buque.git
cd buque
make install

Quick Start

# Initialize
buque init

# Deploy nginx-proxy
buque proxy deploy

# Add environment
buque env add myapp /path/to/myapp

# Start environment
buque up myapp

# Monitor containers
buque stats --continuous

Commands

Command	Description
buque init	Initialize configuration
buque env add <name> <path>	Add environment
buque env list	List environments
buque up [env...]	Start environments
buque down [env...]	Stop environments
buque restart [env...]	Restart environments
buque update [env...]	Update environments
buque stats [env]	Show statistics
buque logs <env>	View logs
buque ps [env...]	List containers
buque proxy deploy	Deploy nginx-proxy
buque pull [env...]	Pull images
buque prune	Clean up resources

Examples

Basic docker-compose.yml with nginx-proxy

version: '3.8'
services:
  web:
    image: nginx:alpine
    expose:
      - "80"
    environment:
      - VIRTUAL_HOST=example.com
      - LETSENCRYPT_HOST=example.com
    networks:
      - nginx-proxy
    labels:
      - "buque.environment=myapp"
networks:
  nginx-proxy:
    external: true

Monitoring

# Real-time stats
buque stats --continuous --interval 2

# Sort by memory
buque stats --sort memory

# Environment-specific
buque stats webapp

Configuration

Default location: ~/.buque/config.yaml

environments:
  - name: webapp
    path: /path/to/webapp
    enabled: true

nginx_proxy:
  enabled: true
  network_name: nginx-proxy
  http_port: 80
  https_port: 443
  ssl_enabled: true

License

MIT License - see LICENSE for details