Skip to content

Quick Start

Try Embucket locally before deploying to AWS.

  1. Start Embucket

    Run the Embucket container:

    Terminal window
    docker run --name embucket --rm -p 3000:3000 embucket/embucket

    You see the following output when the container starts accepting connections:

    Listening on http://0.0.0.0:3000

  2. Configure Snowflake CLI

    Install the Snowflake CLI:

    Terminal window
    python -m pip install snowflake-cli

    Find your configuration path:

    Terminal window
    snow --info

    Open the configuration file and add the following connection block:

    [connections.local]
    host = "localhost"
    region = "us-east-2"
    port = 3000
    protocol = "http"
    database = "embucket"
    schema = "public"
    warehouse = "em.wh"
    account = "acc.local"
    user = "embucket"
    password = "embucket"

    Test the connection:

    Terminal window
    snow connection test -c local

    A successful connection produces the following output:

    +--------------------------------------------------------+
    | key             | value                                |
    |-----------------+--------------------------------------|
    | Connection name | local                                |
    | Status          | OK                                   |
    | Host            | localhost                            |
    | Account         | acc.local                            |
    | User            | embucket                             |
    | Role            |                                      |
    | Database        | embucket                             |
    | Warehouse       | em.wh                                |
    +--------------------------------------------------------+

  3. Run your first query

    Execute a SQL query through the Snowflake CLI:

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

    The query returns a result like the following:

    +-------------------------------+
    | yesterday                     |
    |-------------------------------|
    | 2025-06-24T11:30:00.000+0000 |
    +-------------------------------+

Next steps

Section titled “Next steps”