Support

Maben Base is new, so feedback helps a lot. If something doesn’t work, or you have a question about it, email me directly. I read every message and answer myself.

Email support maxbenschop1@gmail.com

Before you write

If a connection fails or a save is refused, include the engine and its version, the message Base showed (Show details has more), and your macOS version. Leave out passwords and data you can’t share.

Requirements

Mac
macOS 14 or later, on Apple silicon or Intel.
Tools
None for most engines. Oracle needs sqlplus (Instant Client) and DuckDB the duckdb tool.
Account
None. There’s no Maben account to sign up for.

Questions

How do I install it?

Download the disk image, open it and drag Maben Base to your Applications folder. It is signed with my Developer ID and notarized by Apple, so it opens with a double-click.

Which databases does it work with?

PostgreSQL, MySQL and MariaDB, SQLite, SQL Server and Azure SQL, Oracle, ClickHouse, DuckDB, libSQL and Turso, Cloudflare D1, Snowflake, BigQuery, Cassandra and ScyllaDB, MongoDB, and Redis and Valkey. Rows can be edited in all of them. Table structure can be edited in PostgreSQL, MySQL, SQLite, DuckDB and libSQL; in the others the Structure tab shows it.

Do I need to install anything else?

Not for most engines: their drivers are part of the app. Oracle runs through sqlplus from Oracle Instant Client, and DuckDB through the duckdb tool (brew install duckdb). Backup and restore use pg_dump, mysqldump or MariaDB's tools when you have them. BigQuery can use gcloud instead of a service account file.

How do I connect to a server behind SSH?

Turn on SSH in the connection form and fill in the host and user. Base runs your own ssh, so your ~/.ssh/config, agent and jump hosts work as they do in Terminal. A key, a key with a passphrase, or a password all work.

Where are my passwords kept?

In your Keychain, under gg.maben.base. The connections file holds no passwords. When you export connections to move them to another Mac, you choose whether passwords go along; if they do, they are encrypted with a passphrase you pick.

Is it safe to use on a production database?

Nothing is written until you save, and Show SQL shows what will run first. Tag a connection production and it asks before every write. You can also make a connection ask before every query, ask for Touch ID before writes, or never write at all. Edits find rows by primary key, so a table without one is read-only.

What happens if a save fails halfway?

Nothing is kept. All changes run in one transaction, so if one statement fails, the database is left as it was and your edits stay staged in the table. If a row was changed or deleted by someone else since you loaded it, the save stops too.

Does it have a tab or connection limit?

No. There are no limits on tabs, windows, connections, rows or anything else, and no trial. Query results keep the first 50,000 rows by default so a huge result doesn’t fill your memory; in Settings you can raise that or keep every row.

Does it send anything anywhere?

Only to the databases you add, and to GitHub to ask whether there is a new version, which you can switch off in Settings. There is no account, no analytics and no Maben server. If you turn on sync, your connections (without passwords) go through your own iCloud Drive. See Privacy.

How do I get a new version?

It updates itself. It asks GitHub for the latest release at start and every 6 hours, checks that the download is signed by Maben and notarized by Apple, and then installs it. It never restarts while you have a connection open: the update goes in when no connection is open, or as you quit. The Update button in Settings installs it at once, and your connections and tabs come back. You can switch both off in Settings under Updates, and see what changed in the changelog.

Can I see the code?

Yes. Maben Base is open source under the MIT licence, on GitHub. Each engine has its own file in Sources/BaseCore. Bug reports and ideas are welcome as issues.

How do I remove it?

Quit Maben Base, then drag it from Applications to the Trash. Its connections, history and saved queries are in ~/Library/Application Support/Maben Base, and its passwords are in your Keychain under gg.maben.base; delete those too if you want nothing left.