The Connection Form
Every field on the New Connection dialog, explained.
Open the form with Cmd/Ctrl + N or the sidebar New Connection button.
Header
Name
Globally unique, case-insensitive. You'll refer to connections by this name in the CLI and TUI too. If left blank, a name is generated automatically.
Group / Color / Tags
Optional organizational metadata — see Manage Connections and Tags.
Engine & input mode
Pick an engine
Choose from 40+ supported engines. Port and other defaults fill in automatically.
Fields mode vs URL mode
- Fields — fill host / port / credentials separately
- URL — paste a full connection URL; RaisDB parses it and round-trips into fields
Serverless engines (Supabase, Neon, PlanetScale, …) are locked to URL mode because they use token-based connection strings.
Connection fields
Network
| Field | Required | Notes |
|---|---|---|
| Host | yes | IP or domain; defaults to 127.0.0.1 |
| Port | yes | defaults to the engine's standard port |
| Username | usually | label changes to "API Key" on HTTP-style engines |
| Password | usually | stored in the OS keychain, never on disk |
| Database | optional | connect server-wide if left blank |
Per-engine extras
- Redis —
db_indexinstead of database - Oracle — service-name / SID toggle (defaults to service name)
- File engines (SQLite / DuckDB) —
file_pathonly, no network
Advanced
Timeouts & pool
connection_timeout, query_timeout, max_pool_size are exposed via the config file / CLI, not the basic form.
SSL / TLS
A dropdown to pick an SSL mode.
SSH Tunnel
A toggle to enable an SSH tunnel — Pro feature.
Test vs Save
Test
Test opens a throwaway connection, runs ping, reports server_version + latency_ms, then tears the pool down. Nothing is persisted.
Save
Save validates name uniqueness + the Free-tier connection cap (3), then persists the config to SQLite. It does not connect — the real pool is created the first time you click the connection in the sidebar.