v0.19.5

What's Changed

• Add support for archiving and restoring reports
• Improve handling of large map configurations and add gRPC size limit warnings
• Gracefully handle client disconnects in gRPC streams
• Show "Result is empty" message for SQL queries with no rows
• Add EmptyResultError for better error clarity on blank datasets

Full 0.19 release notes

v0.19.2

What's Changed

• Fix dataset loading stuck by @delfrrr in #250

Full 0.19 relese notes

v0.19

Feature Highlights

Wherobots Integration (Beta)

Run large-scale spatial jobs on Wherobots® clusters directly from Dekart.

👉 Try Live Demo

Kepler.gl 3.x Upgrade

Dekart now runs on Kepler.gl 3.x / Deck.gl 9.x, delivering new Kepler features and faster load times for large maps.

New Dataset Panel Interface

The Dataset Panel has been redesigned:

Per-Email Sharing

Share maps with specific email addresses in View-Only mode to let others explore without editing.

Mandatory Configuration Change

Dekart 0.19 requires explicit configuration of storage and datasource backends:

# Where Dekart stores files and query results
DEKART_STORAGE=USER
# Default SQL datasource for new maps
DEKART_DATASOURCE=USER

Dekart will not start without these variables set.

Fixes & Improvements

• Map no longer reloads during layer edits
• Stable large dataset downloads for Snowflake and Athena
• Titles sync correctly after report renames
• UI improvements: responsive headers, updated tooltips, smoother dataset panel

Migration Steps

1. Backup your Postgres database.
2. Upgrade your image:

dekartxyz/dekart:0.18 → dekartxyz/dekart:0.19

3. Set the required environment variables DEKART_STORAGE and DEKART_DATASOURCE.

v0.18.5

What's Changed

• Fix map reloads when edit by @delfrrr in #244

Full Changelog: v0.18.4...v0.18.5

v0.18.4

What's Changed

• Bug fixies in stream updates @delfrrr in #227
• Update Snowflake configuration to use private key instead of password by @delfrrr in #231
• Fix report forking and add coverage by @delfrrr in #235

Full Changelog: v0.18.3...v0.18.4

v0.18

Feature Highlights

Query Parameters

Turn your maps into data applications! Add {{parameters}} to your SQL and UI inputs. Parameters are added to the URL, so you can share parameterized maps. Filter multiple queries with the same dimension using the same {{parameter}}.

Auto‐Save

Automatic map saving and sync between users. No need to press Save. Changes are synced and updated without page reload.

User Roles & Workspaces

Assign roles (viewer, editor, admin) to your collaborators and organize projects by workspace, making it easier to manage permissions and keep your maps organized.

Note: when migrating from previous versions all users and maps will be moved to "Default" workspace.

To fine-tune workspace permissions and default roles, we’ve added following configuration variables

• DEKART_ALLOW_WORKSPACE_CREATION

  • When set to true, users can create new workspaces. Set to false new users will be automatically added to Default workspace.

• DEKART_DEFAULT_WORKSPACE_ADMIN

  • Email that designates a default admin for Default workspace. When not provided all new users will be Admin. When provided all users will be viewers, unless specified differently with DEKART_DEFAULT_WORKSPACE_ROLE

• DEKART_DEFAULT_WORKSPACE_ROLE

  • Role assigned by default to new users (e.g., viewer, editor, admin). Requires DEKART_DEFAULT_WORKSPACE_ADMIN to be specified

Markdown README Support

Add READMEs to your maps and make them self-explanatory.

BigQuery Service Account Keys

Create connections using JSON service account keys—ideal when users don’t have direct BigQuery access or prefer not to rely on personal Google credentials.

Note: The DEKART_DATA_ENCRYPTION_KEY setting is required for this feature.
This key ensures secure storage of sensitive data, such as service account details.

DEKART_DATA_ENCRYPTION_KEY is an environment variable used to encrypt and decrypt sensitive information inside Dekart (for example, the JSON credentials for BigQuery). By setting this key, you enable Dekart to securely manage stored credentials.

Usage:

• Set DEKART_DATA_ENCRYPTION_KEY to a base64‐encoded, 32‐byte (256‐bit) encryption key.
• Dekart uses this key for all encryption/decryption operations related to credentials.

Steps to Generate & Set the Key:

1. Generate a Secure 256‐Bit Key
   Use a command like:

   openssl rand -base64 32

   This produces a base64‐encoded, 32‐byte key.

2. Add key to Google Secret Manager

3. Set the Environment Variable
   Add this key to your .env file or environment configuration:

   DEKART_DATA_ENCRYPTION_KEY=projects/121212121212/secrets/dekart-data-encoding-key/versions/1

With DEKART_DATA_ENCRYPTION_KEY in place, Dekart can securely handle BigQuery Service Account Keys and Snowflake credentials.

---

Other Notable Changes

• Click House Support, contributed by @Tsovak
• Allow Export: Toggle dataset downloads at the report level for tighter data control.
• Snowflake Improvements: Fixed re‐run errors, improved large download stability.
• Enhanced UI & Logging: Clearer error messages, better workspace screens, and more robust logs.
• Security Updates: Upgraded to Go 1.21, updated backend dependencies
• DEKART_GCP_EXTRA_OAUTH_SCOPES now also applied to OAuth tokens

---

Migration Guide

Important: always backup Postgres database before performing update

Note: when authentfication enabled, all current users and maps will be migrated to "Default" workspace. You can manage and rename via UX afterwords.

For all Docker-based deployments, update the docker tag, for example dekartxyz/dekart:0.17 -> dekartxyz/dekart:0.18

You’re all set! Enjoy the new features in Dekart 0.18.

v0.17.0

License Update

Open source project was changed to AGPL-3.0.

If you need modify Dekart without publishing your changes open-source (as required by AGPL-3.0), commercial license is available. Please contact us at [email protected]

Feature Highlights

New logo and header refresh

New report sharing dialog

Breaking change: From now, private reports will not be visible to other users by default. View permission must be explicitly set.

Snowflake temp query result storage support

Now you can set DEKART_STORAGE=SNOWFLAKE. Data will be cached in Snowflake temp query storage for 24 hours. After cache expires, query will re-run on next map visit.

Other features

• BigQuery connection project selector
• Dekart works correctly when user is logged into multiple Google Accounts
• Security updates by @delfrrr in #197

Fixes

• Fix error when requesting auth by @delfrrr in #164
• Improve Empty result handling
• Fix error handling for Snowflake queries
• Fix layer reordering when updating data
• Fix connection update by @delfrrr in #181
• Fix connection validation #184
• Fix asking login every time with Goole Auth
• Fix forking

v0.16.0

Feature Highlights

Collaborate better on Reports

Empower teamwork with our new editing and refresh features for shared reports. Now, every user can refresh data with a simple click, ensuring everyone has the latest insights at their fingertips. Plus, grant editing access to trusted colleagues to foster a truly collaborative environment.

Query data from Postgres database

Thanks to @Tsovak contribution you now can configure Dekart to query PostgreSQL! PostgreSQL, when paired with the PostGIS extension, becomes an incredibly powerful database for managing and querying geospatial data due to its ability to efficiently store, index, and perform complex spatial queries.

👉 Documentation

Manage connections (BigQuery)

Dekart now introduces dedicated space, which allows you to seamlessly configure and manage connections, streamlining your workflow and enhancing your data interaction experience.

What's Changed

Features

• User icon with logout and switch user buttons (Google OAuth only) by @delfrrr #147
• Refresh Button by @delfrrr in #153
• Report data updated label by @delfrrr in #154
• Shared Connections by @delfrrr in #155
• Postgres datasource support by @Tsovak in #156
• Allow edit reports by @delfrrr in #159
• Acceess error info by @delfrrr in #161
• Ux improvements by @delfrrr in #162

Dev

• Support dev email for Google OAuth flow by @delfrrr in #148
• User refresh token for development with Google OAuth by @delfrrr in #149

Fixes

• Fix storage connection test by @delfrrr in #150
• Fix auth error infinite loop by @delfrrr in #151
• Fix header aligments by @delfrrr in #152
• Fix playground 500 by @delfrrr in #160

Links

Upgrade from previous version

Documentation

Dekart Cloud ✨

v0.15.0

Features

Pass-through authentication with Google OAuth 2.0 Flow

No Google Service account required any more!

This feature allows Dekart to authorize users via Google OAuth 2.0 and pass user-specific tokens to access BigQuery and Cloud Storage. No more need for a universal service account or setting GOOGLE_APPLICATION_CREDENTIALS! Plus, all tokens are stored only in your browser memory, offering an additional layer of security.

Required User Permissions:

• BigQuery Data Viewer
• BigQuery Job User
• BigQuery Read Session User
• Storage Object User

Note: This feature is currently only supported for BigQuery and Cloud Storage data sources.

How to enable?

Set these environment variables to get started:

• DEKART_REQUIRE_GOOGLE_OAUTH=1
• DEKART_GOOGLE_OAUTH_CLIENT_ID=Your-Client-ID
• DEKART_GOOGLE_OAUTH_CLIENT_SECRET=Your-Client-Secret

Create Data Connections directly through the UI

Now Dekart users can create Data Connections directly through the UI, stepping away from the single configuration approach facilitated by environment variables. Coupled with the recently implemented pass-through authentication, this upgrade empowers users and admins with unparalleled control over the data stored and cached.

Currently, only BigQuery supported DEKART_DATASOURCE=BQ.

To enable the feature, leave empty DEKART_BIGQUERY_PROJECT_ID= and/or DEKART_CLOUD_STORAGE_BUCKET=

Links

Upgrade from previous version

Documentation

Contribute 💜

v0.14.1

This is a hotfix for release v0.14.0

Fixes

• Fix Amazon OIDC integration (#134)

How to upgrade

The following images have been updated: dekartxyz/dekart:0.14.1, dekartxyz/dekart:0.14, dekartxyz/dekart:latest

Upgrade from previous versions

Links

Documentation

Contribute 💜