Embucket Documentation

Run Snowflake SQL dialect on your data lake in 30 seconds. Zero dependencies.

Wire-Compatible Snowflake for Apache Iceberg

Single binary lakehouse providing Snowflake SQL dialect and API compatibility with Apache Iceberg storage. Perfect for simple deployments.

Get Started →

View on GitHub

Key Features

Snowflake Compatible

Use existing Snowflake queries, dbt projects, and BI tools without modification

Apache Iceberg Storage

Your data stays in Apache Iceberg format with ACID guarantees and no lock-in

Single Binary Deployment

Zero dependencies, radical simplicity. Deploy anywhere from laptops to Lambda

Horizontal Scaling

Query-per-node architecture. Add nodes for more throughput

Quick Start

Get Embucket running in 30 seconds:

1. Start Embucket

   Run the Docker container and expose the API on port 3000:

   docker run --name embucket --rm -p 3000:3000 embucket/embucket
   
2. Connect with Snowflake CLI

   Install and configure the Snowflake CLI to connect to your local Embucket instance:

   pip install snowflake-cli
   snow connection add --connection-name local \
     --host localhost --port 3000 --protocol http \
     --account acc.local --user embucket --password embucket
   
3. Run Your First Query

   Execute Snowflake SQL against your local instance:

   snow sql -c local -q "select dateadd(day, -1, current_timestamp()) as yesterday;"
   

Ready to deploy? Check out our deployment guides for Docker, AWS Lambda, and bare metal options.

Use Cases

dbt Development

Run your dbt Snowflake projects locally for fast development cycles

Data Lake Querying

Query S3 Tables and external Iceberg catalogs with Snowflake SQL

Serverless Analytics

Deploy on AWS Lambda for cost-effective, on-demand query execution

Built on Proven Open Source

Embucket combines industry-standard technologies:

• Apache DataFusion — High-performance SQL execution engine
• Apache Iceberg — ACID table metadata and storage format
• Rust — Memory-safe systems programming for reliability and performance

Next Steps

Introduction

Learn about Embucket’s architecture and design principles

Installation

Install Embucket on your preferred platform

Configuration

Configure catalogs, storage, and performance settings

API Reference

Explore CLI flags, environment variables, and REST APIs