Download Latest Version DBLab Engine v4.0.0 source code.tar.gz (5.3 MB)
Email in envelope

Get an email when there's a new version of Database Lab Engine (DLE)

Home / v3.4.0
Name Modified Size InfoDownloads / Week
Parent folder
DBLab Engine v3.4.0 source code.tar.gz 2023-08-14 5.7 MB
DBLab Engine v3.4.0 source code.zip 2023-08-14 6.2 MB
README.md 2023-08-14 14.5 kB
Totals: 3 Items   11.8 MB 0


New name: DBLab Engine

The new name for the Database Lab Engine is "DBLab Engine". Updates are currently underway across our materials to reflect this change. To align with this change, we have introduced specific domains for the product: dblab.dev and dblab.sh. For ease of access, we have established the following short URLs: - https://cli.dblab.dev/ and https://dblab.sh – CLI setup script (works on macOS/Linux/Windows: curl -sSL dblab.sh | bash) - https://demo.dblab.dev/ – DBLab 3.4 demo (token: demo-token) - https://branching.dblab.dev/ – DBLab 4.0-alpha demo, implementing full-fledged DB branching and snapshots on demand (token: demo-token) - https://aws.dblab.dev/ – DBLab SE page in AWS Marketplace - https://docs.dblab.dev/ – the docs - https://api.dblab.dev/ – interactive API reference (powered by readme.io)

New contributors

:bow: Many thanks to our first-time contributors: @mbobin, @TheLiamGuy, @gromsterus, @ibash, @byx01, @davidsvenson.

By the numbers

Thank you for the support!

New DBLab SE installer

We've expanded the installation options for DBLab SE. Besides its presence in the AWS Marketplace, you can now seamlessly install DBLab SE directly from the Postgres.ai Console.

This setup is entirely automated and can be used anywhere: - For those who have existing machines, we support the "BYOM" (Bring Your Own Machine) method - If you're utilizing AWS, GCP, DigitalOcean, or Hetzner Cloud, the installer handles resource provisioning—including VMs, disks, and more—automatically.

Check out the updated tutorial.

Migration notes

For those considering an upgrade, we recommend executing a fresh installation of DBLab. At present, we don't have automation in place for upgrades. If you need to update an existing DBLab installation, it's essential to stop and remove the current containers. Then, initiate a fresh start of the DBLab container using the 3.4.0 tag. More details can be found in the docs. Before initiation, ensure you've adjusted the DBLab configuration as outlined below.

Postgres images

There is a new method for running clones with customized port and socket directories. Please note that this is NOT backward compatible with previous versions of the Postgres images that DBLab utilized. It is crucial to ensure the dockerImage options utilize tags with the -0.3.0 suffix or later, such as postgresai/extended-postgres:15-0.3.0 (details can be found in this MR).

Global telemetry

The global.telemetry subsection has been deprecated and removed. The control to activate/deactivate telemetry has been relocated to the platform section:

:::yaml
platform:
  url: "https://postgres.ai/api/general"
  enableTelemetry: true

Platform

From version v3.4.0 onward, the platform section is enabled by default.

If either the accessToken or orgKey keys aren't empty, ensure the url parameter is specified; otherwise, the DBLab instance will not initialize. By default, neither accessToken nor orgKey are defined when in case of self-managed installations.

:::yaml
platform:
  url: "https://postgres.ai/api/general"
  enableTelemetry: true
#  orgKey: "org_key"
#  accessToken: "platform_access_token"

Docker mounts

Please omit the following Docker mount directives during container startup, as they are no longer necessary:

:::shell
    --volume /sys/kernel/debug:/sys/kernel/debug:rw \
    --volume /lib/modules:/lib/modules:ro \
    --volume /proc:/host_proc:ro \

Changelog

New features

Improvements and fixes

Internal changes

Full diff

Diff between versions v3.3.0 and v3.4.0: https://github.com/postgres-ai/database-lab-engine/compare/v3.3.0...v3.4.0

Where to start / get help

Provide feedback, contribute

We greatly value your feedback. Connect with us via: - X/Twitter @Database_Lab - LinkedIn - DBLab Community Slack

Additional resources where you can get insights about DBLab and Postgres: - YouTube channel PostgresTV - Podcast Postgres.FM

Interested in giving back to the project? Here's how you can make an impact: - Give a star to our GitHub repository - Help us reach more enthusiasts. Share about Database Lab on Twitter (don't forget to tag @Database_Lab) or any other platform you fancy - Multilingual? Consider translating our README.md to share the knowledge in your language - Are you a developer? Dive in and enhance the Database Lab Engine (DLE) experience; check out our CONTRIBUTING guidelines and explore the "good first issues" list on GitLab

Source: README.md, updated 2023-08-14