Licensing#

Every edg feature is free. A license is only required for four enterprise drivers: Oracle, Microsoft SQL Server, AWS Aurora DSQL, and Google Cloud Spanner.

Drivers#

Driver	Flag Value	License Required
PostgreSQL / CockroachDB	`pgx`	No
MySQL	`mysql`	No
MongoDB	`mongodb`	No
Cassandra	`cassandra`	No
SQLite	`sqlite`	No
Redis / Valkey	`redis`	No
In-memory cache (testing)	`test`	No
Oracle	`oracle`	Yes
Microsoft SQL Server	`mssql`	Yes
AWS Aurora DSQL	`dsql`	Yes
Google Cloud Spanner	`spanner`	Yes

Features#

No feature is license-gated. capture, compare, cluster, init, jobs, scaffold, sync, embeddings, LLM completions, expectations, WASM plugins, Prometheus metrics, signals, seasons, sim, the TUI, every distribution namespace, and any number of workers are all free.

Running against a free driver needs no license key at all.

Buy Pro#

Need one of the four enterprise drivers? Visit the Purchase page for monthly and yearly options.

For seat counts or custom terms, contact lic@edg.run.

Activating Your License#

After receiving your license key, activate your machine:

edg activate --license "your-license-key"

Activating machine a1b2c3d4e5f6...
Machine activated successfully.
License cached to /home/you/.edg/license.lic

This registers your machine with the license server and caches a signed license file locally for offline use. You only need to do this once per machine.

Using Your License#

Provide your license key via the --license flag or the EDG_LICENSE environment variable:

# Flag.
edg all \
  --driver oracle \
  --license "your-license-key" \
  --config workload.edg \
  --url "oracle://user:pass@localhost:1521/XEPDB1"

# Environment variable (recommended).
export EDG_LICENSE="your-license-key"

edg all \
  --driver oracle \
  --config workload.edg \
  --url "oracle://user:pass@localhost:1521/XEPDB1"

Offline Use#

After activation, edg works offline using the cached license file at ~/.edg/license.lic. The cache is valid for 30 days, after which edg will need to reach the license server to re-validate.

Deactivating a Machine#

To release a seat (e.g. before moving to a new machine):

edg deactivate --license "your-license-key"

This removes the machine from your license and deletes the local cache.

Checking Your License#

Use validate license to inspect license details without connecting to a database:

edg validate license --driver oracle --license "your-license-key"

License info:
  ID:           a1b2c3d4-e5f6-7890-abcd-ef1234567890
  Name:         Acme Corp
  Entitlements: pro
  Expires at:   2027-05-11
  Status:       VALID
  Machine:      a1b2c3d4e5f6...
License is valid for driver "oracle".

Docker#

In Docker, the machine fingerprint changes per container. Set a stable identity with EDG_MACHINE_ID:

docker run \
  -e EDG_LICENSE="your-license-key" \
  -e EDG_MACHINE_ID="my-ci-runner" \
  codingconcepts/edg activate

To persist the activation across container restarts, mount the cache directory:

docker run \
  -v edg-license:/root/.edg \
  -e EDG_LICENSE="your-license-key" \
  codingconcepts/edg all --driver oracle --config workload.edg --url "..."

Error Reference#

Error	Meaning
`driver "X" requires a license`	No license provided for one of the four enterprise drivers. Set `--license` or `EDG_LICENSE`.
`machine not activated; run 'edg activate' first`	License key is valid but this machine hasn’t been activated.
`license has expired`	License has passed its expiry date. Renew or contact lic@edg.run.
`license does not include pro entitlement`	License is valid but not on a pro plan.
`machine limit exceeded`	All seats are in use. Deactivate another machine first.
`cached license is stale`	Offline cache is older than 30 days. Connect to the internet to re-validate.
`license has been suspended`	License was suspended by the administrator. Contact lic@edg.run.

By purchasing or using edg, you agree to the Terms of Use and Privacy Policy.