Loggy - Conversational Log Analysis

Quick reference for your installation.

Directory Structure

/path/to/loggy/           # Your installation directory
├── data/                 ← Database
├── logs/aggregated/      ← Processed logs for AI
├── exports/              ← Conversation exports
├── scripts/              ← Maintenance scripts
└── docker-compose.yml    ← Container definition

Common Commands

Start/Stop Container

cd /path/to/loggy
docker-compose up -d        # Start
docker-compose down         # Stop
docker-compose restart      # Restart
docker-compose logs -f      # View logs

Manual Log Aggregation

# Set paths to match your installation
export LOGGY_DB=/path/to/loggy/data/conversations.db
export LOG_DIR=/path/to/loggy/logs/aggregated
./scripts/aggregate-logs-enhanced.sh

Access Web Interface

http://your-server-ip:8181

Configure API Key (First-Time Setup)

Option 1: Via Web UI (Recommended)

1. Navigate to http://your-server-ip:8181
2. Go to Settings → AI Provider tab
3. Enter your Anthropic API key
4. Click "Test Connection" to verify
5. Click "Save API Key"

Option 2: Via Environment Variable (Legacy) Edit .env file in your installation directory:

ANTHROPIC_API_KEY=sk-ant-api03-...

Then restart: docker-compose restart

Note: UI configuration takes priority over environment variables.

View Database Size

du -h /path/to/loggy/data/conversations.db

Backup Everything

tar -czf loggy-backup-$(date +%Y%m%d).tar.gz /path/to/loggy/

Restore

tar -xzf loggy-backup-YYYYMMDD.tar.gz -C /path/to/restore/

Configuration

Web UI (Recommended):

• Navigate to Settings → AI Provider tab for API key management
• Settings → Services for log source configuration
• Settings → Context for custom environment details
• Changes take effect immediately (no restart required)

Configuration File (Legacy): Edit: .env file in your installation directory

After editing, restart container:

cd /path/to/loggy
docker-compose restart

Troubleshooting

Container won't start:

docker-compose logs

No logs appearing:

1. Check aggregation script ran: ls -lh /path/to/loggy/logs/aggregated/
2. Run manually with correct paths (see Manual Log Aggregation above)

API errors:

• Check API key in Settings → AI Provider tab
• Use "Test Connection" button to verify key
• Alternatively, verify API key in your .env file
• Get a new key: https://console.anthropic.com/

Support

GitHub: https://github.com/VeryHarry7/Loggy