Skip to content

Getting started ​

DBPinball is a database workspace for MySQL and PostgreSQL. This section takes you from a clean machine to a working connection, in the terminal or in the desktop app.

The short version ​

  1. Check the requirements.
  2. Build from source with installation.
  3. Follow the quick start.
  4. Create your first connection.

Two front ends, one store ​

The CLI and the desktop share one connection store at dirs::config_dir()/dbpinball/connections.json and one OS keyring entry per profile. A profile created in the CLI appears in the desktop, and the other way around. You do not need to keep two sets of profiles.

What this documentation covers ​

SectionWhat it answers
GuideHow to install and use DBPinball
ArchitectureHow the core, the CLI, the desktop and the store fit together
SecurityHow credentials are stored, and what the limits are
ReferenceExact commands, configuration and error behaviour
DevelopmentHow to build, test and contribute
RoadmapWhat is implemented, what is planned, what is not available

Not a marketing page

Every capability described here is taken from the repository and its tests. If a feature is planned or incomplete, it is labelled as such.

Released under the MIT License.