Parseable

Key Features

• SQL-based log querying with standard syntax for familiar data exploration and analysis
• RESTful API endpoints for programmatic log ingestion from applications and services
• Real-time log analytics with instant search and filtering capabilities
• Lightweight Rust-based architecture requiring minimal system resources compared to Java-based alternatives
• Web-based dashboard for log visualization, stream management, and query execution
• JSON-native log processing with automatic field detection and indexing
• Local storage backend with staging area for efficient data processing workflows
• Built-in authentication system with configurable user credentials for secure access

Common Use Cases

• 1Application debugging and error tracking for development teams working with microservices
• 2Centralized logging for small to medium-sized container orchestration environments
• 3Cost-effective log analytics for startups looking to replace expensive SaaS logging solutions
• 4Development environment log aggregation where SQL skills are more common than Elasticsearch expertise
• 5Homelab monitoring and system administration for self-hosted infrastructure
• 6CI/CD pipeline log analysis and build troubleshooting with structured query capabilities
• 7IoT device log collection and analysis for edge computing scenarios with resource constraints

Prerequisites

• Docker Engine 20.10+ and Docker Compose V2 for container orchestration
• Minimum 512MB RAM available for the Parseable container and data processing
• Port 8000 available on the host system for web interface access
• At least 2GB free disk space for Docker volumes and log data storage
• Basic understanding of SQL syntax for effective log querying and analysis
• Network connectivity for pulling the parseable/parseable Docker image from Docker Hub

docker-compose.yml

1services: 
2  parseable: 
3    image: parseable/parseable:latest
4    container_name: parseable
5    restart: unless-stopped
6    command: 
7      - parseable
8      - local-store
9    environment: 
10      P_USERNAME: ${P_USERNAME}
11      P_PASSWORD: ${P_PASSWORD}
12    volumes: 
13      - parseable_data:/parseable/data
14      - parseable_staging:/parseable/staging
15    ports: 
16      - "8000:8000"
17    networks: 
18      - parseable-network
19
20volumes: 
21  parseable_data: 
22  parseable_staging: 
23
24networks: 
25  parseable-network: 
26    driver: bridge

.env Template

1P_USERNAME=admin
2P_PASSWORD=changeme

Usage Notes

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  parseable:
5    image: parseable/parseable:latest
6    container_name: parseable
7    restart: unless-stopped
8    command:
9      - parseable
10      - local-store
11    environment:
12      P_USERNAME: ${P_USERNAME}
13      P_PASSWORD: ${P_PASSWORD}
14    volumes:
15      - parseable_data:/parseable/data
16      - parseable_staging:/parseable/staging
17    ports:
18      - "8000:8000"
19    networks:
20      - parseable-network
21
22volumes:
23  parseable_data:
24  parseable_staging:
25
26networks:
27  parseable-network:
28    driver: bridge
29EOF
30
31# 2. Create the .env file
32cat > .env << 'EOF'
33P_USERNAME=admin
34P_PASSWORD=changeme
35EOF
36
37# 3. Start the services
38docker compose up -d
39
40# 4. View logs
41docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/parseable/run | bash

Troubleshooting