Installation & Prerequisites

Get Placino up and running on your infrastructure. We support Docker, Docker Compose, and Kubernetes deployments.

System Requirements

Hardware

• Minimum: 4 CPU cores, 8GB RAM, 50GB disk
• Recommended: 8+ CPU cores, 32GB RAM, 200GB+ disk
• Production: Kubernetes cluster with persistent volume storage

Software

• Docker 20.10+ or Podman 3.0+
• Docker Compose 1.29+ (for multi-container deployments)
• Linux kernel 5.10+ or macOS 12+ or Windows 10/11 with WSL2
• Port availability: 5432 (PostgreSQL), 6379 (Redis), 8080 (API), 9090 (Prometheus)

Database Connectors (Optional)

Placino integrates with these database systems:

• PostgreSQL 12+
• MySQL 8.0+
• BigQuery (Google Cloud)
• Snowflake
• Redshift (AWS)
• ClickHouse
• Databricks
• Salesforce (via API)

Docker Installation

# Pull the latest Placino image

docker pull placino/core:latest

# Run with minimal configuration

docker run -d \
  --name placino \
  -p 8080:8080 \
  -e DATABASE_URL="postgres://user:pass@host:5432/placino" \
  -e ENCRYPTION_KEY="$(openssl rand -base64 32)" \
  placino/core:latest

The container will initialize the database schema automatically on first run. Check logs with docker logs placino.

Docker Compose (Recommended for Dev)

For local development, we provide a docker-compose.yml that brings up all 35 containers with proper networking and volumes.

# Clone the repository

git clone https://github.com/placino/placino.git && cd placino

# Start all services

docker-compose -f docker-compose.dev.yml up -d

# Verify all containers are running

docker-compose ps

# Check logs

docker-compose logs -f core-api

Once started, the API will be available at http://localhost:8080 and the web UI at http://localhost:3000.

Key Environment Variables

DATABASE_URL

PostgreSQL connection string (required). Format: postgres://user:pass@host:port/dbname

ENCRYPTION_KEY

32-byte base64-encoded key for envelope encryption. Generate with openssl rand -base64 32

REDIS_URL

Redis connection for caching and message queues. Default: redis://localhost:6379

LOG_LEVEL

Logging verbosity: DEBUG, INFO (default), WARN, ERROR

PRIVACY_EPSILON

Default differential privacy epsilon budget per query. Default: 1.0 (stricter privacy)

Verify Installation

Check that Placino is running by making a test request to the health endpoint:

curl http://localhost:8080/health

Response:

{ "status": "healthy", "uptime": "1.23s", "database": "connected" }

If all systems report healthy, you're ready to proceed with data ingestion and querying.

Next: Quickstart Guide

Now that Placino is installed, follow our 5-minute quickstart to set up your first data ingestion and run a query.

Go to Quickstart