Open the form with Cmd/Ctrl + N or the sidebar New Connection button.

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_index instead of database
Oracle — service-name / SID toggle (defaults to service name)
File engines (SQLite / DuckDB) — file_path only, no network

Advanced

Timeouts & pool

connection_timeout, query_timeout, max_pool_size are exposed via the config file / CLI, not the basic form.

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 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.

The Connection Form

Header