Licensing#

edg is free for PostgreSQL/CockroachDB, MySQL, MongoDB, and Cassandra. Pro drivers and features (embeddings, LLM completions, jobs, sync, scaffold, metrics, plugins, and TUI) require a paid license.

Free vs Pro#

Drivers#

Features#

☑️ Included

Buy Pro#

Ready to subscribe? 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#

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