# Buque Docker Compose Manager

## Quick Links

- [Installation](#installation)
- [Quick Start](#quick-start)
- [Commands](#commands)
- [Examples](#examples)
- [Configuration](#configuration)

## Installation

### Requirements
- Go 1.21+
- Docker 20.10+
- Docker Compose V2

### Install from source

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

## Quick Start

```bash
# 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

```yaml
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

```bash
# 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`

```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](LICENSE) for details