Astralog Logo Astralog Docs

Quickstart

You can deploy the entire AstraLog stack (including MinIO and ClickHouse) on your local machine to test ingestion and analytics in under 2 minutes.

Prerequisites

  • Docker & Docker Compose
  • Go 1.22+ (Required to run the ingestion engine)

1. Clone and Boot Infrastructure

First, clone the repository and start the required databases using the provided docker-compose.yml file.

git clone https://github.com/yourusername/astralog.git
cd astralog

Spin up MinIO (S3) and ClickHouse:

docker-compose up -d

2. Configure Environment

Copy the example environment file. This file contains the default credentials to connect to the local Docker containers.

cp .env.example .env

3. Run the AstraLog Engine

Start the Go ingestion server. It will automatically connect to ClickHouse, initialize the required tables, and start the S3 Syncer.

go run cmd/server/main.go

Expected Output:

✔ ClickHouse connected and tables initialized
✔ S3-to-ClickHouse Syncer activated
AstraLog server starting on port 8080
Ingestion pipeline started

4. Run the Stress Test

Want to see AstraLog’s performance immediately? While the server is running, open a new terminal and run the included benchmarking tool.

go run tests/stress.go

This will spawn 50 concurrent workers, generating 100,000 logs instantly.

5. Verify the Data in ClickHouse

Wait a few seconds for the Syncer to move the data from MinIO to ClickHouse, then query the database to verify ingestion:

curl -s -u default:logpassword "http://localhost:8123/?query=SELECT+count()+FROM+astralog.logs"

You should see 100000 returned.