# Log Client (Promtail)

Ships Docker and system logs to Log Server. Zero configuration!

## Quick Start

1. **Configure** (edit `config/service.env`):
```bash
LOGSERVER_HOST=<server-ip>  # Your log server IP
LOGSERVER_PORT=3100         # Default Loki port
LOKI_USER=logclient         # Default username
LOKI_PASSWORD=<password>    # Get from server admin
```

2. **Install**:
```bash
dropshell install logclient
```

That's it! Logs are now shipping to your central server.

## What Gets Sent
- All Docker container logs (via Docker API)
- System logs (/var/log/syslog)
- Auth logs (/var/log/auth.log)
- Hostname is automatically included

## View Your Logs
Go to: `http://<logserver-ip>:3000`
- Click Dashboards → Central Logs
- Your server's logs appear with its hostname

## Features
- **Zero maintenance** - Just runs
- **Lightweight** - ~20MB RAM
- **Automatic** - Finds all containers
- **Labeled** - Hostname included automatically

## Simple Authentication
Just a username/password - much simpler than ELK's API key system!

## Troubleshooting
Check if client is running:
```bash
./status.sh
```

View client logs:
```bash
./logs.sh
```

Test connection to server:
```bash
nc -zv <logserver-ip> 3100
```