Documentation

Get started in 5 minutes

Connect your Snowflake account, grant read-only access, and see your cost breakdown immediately.

Need help?

support@gelida.dev

Quickstart

Three steps from signup to your first cost dashboard.

01

Create your Gelida account

Sign up at gelida.dev/signup. No credit card required. You get a 3-day free trial with Starter plan access — enough to connect your account and see your spend breakdown.

Create account →
02

Create a dedicated Snowflake user and warehouse

Gelida needs a dedicated service user with read-only access to ACCOUNT_USAGE, plus a small dedicated warehouse (GELIDA_WH) to run its metadata queries in isolation. Run this SQL in your Snowflake account as ACCOUNTADMIN:

-- Step 1: Create a dedicated role
CREATE ROLE IF NOT EXISTS GELIDA_ROLE;

-- Step 2: Grant access to ACCOUNT_USAGE (cost metadata only — no business data)
GRANT IMPORTED PRIVILEGES ON DATABASE SNOWFLAKE TO ROLE GELIDA_ROLE;

-- Step 3: Grant account monitor (required for resource monitor and billing views)
GRANT MONITOR ON ACCOUNT TO ROLE GELIDA_ROLE;

-- Step 4: Create a dedicated XS warehouse for Gelida queries
-- Auto-suspends after 60s — costs almost nothing, keeps Gelida isolated
CREATE WAREHOUSE IF NOT EXISTS GELIDA_WH
  WAREHOUSE_SIZE = 'X-SMALL'
  AUTO_SUSPEND = 60
  AUTO_RESUME = TRUE
  INITIALLY_SUSPENDED = TRUE
  COMMENT = 'Dedicated warehouse for Gelida cost analytics queries';

-- Step 5: Grant warehouse usage
GRANT USAGE ON WAREHOUSE GELIDA_WH TO ROLE GELIDA_ROLE;

-- Step 6: Create a service user
CREATE USER IF NOT EXISTS GELIDA_USER
  PASSWORD = 'your-strong-password-here'
  DEFAULT_ROLE = GELIDA_ROLE
  DEFAULT_WAREHOUSE = GELIDA_WH
  MUST_CHANGE_PASSWORD = FALSE;

-- Step 7: Assign the role
GRANT ROLE GELIDA_ROLE TO USER GELIDA_USER;
03

Connect in Gelida

Go to Settings → Connections → Add Connection. Enter your Snowflake account identifier, the GELIDA_USER credentials, and GELIDA_WH as the warehouse. Gelida tests the connection and loads your dashboard in seconds.

💡 Your account identifier uses the format: orgname-accountname (e.g. acmedata-prod1234). Find it in Snowflake under Admin → Accounts. The old region-based format (xy12345.ap-southeast-1.aws) is deprecated.