Onboarding
Create Your First Connection
Link your uploaded SSH key to a remote host so SQLitePilot can open the managed tunnel.
Last updated: Dec 8, 2025
Connections tell SQLitePilot where your database lives and which key to use. After you set one up, it appears on the dashboard so you can connect with one click.
What to prepare
- One SSH key stored on the Keys page.
- The server address, SSH username, and the full path to the
.dbfile (for example/var/www/app/data.sqlite).
Step 1: Open the page
- Go to Connections.
- If you still need a key, follow the link on the yellow banner to add one first.
Step 2: Start a new connection
- Select Add new connection.
- If you are on the free plan and already have one saved, you will see a blue notice explaining that you must delete the old one or upgrade before continuing.
Step 3: Fill in the details
- Name: choose something clear like “Production orders.”
- Server IP or hostname: the address you SSH into today.
- SSH username: the account that owns the database file (often
root,user, ordeploy). - Database path: the full path to the SQLite file on the server (for example
/home/deploy/apps/orders/db.sqliteor/root/data/analytics.db). - Platform: leave the suggested option unless support told you otherwise.
- SSH Key: pick the entry you uploaded earlier.
The Save button becomes active once every field is filled out.
Step 4: Save and check the list
- Click Save.
- The dialog closes and the new connection appears in the table. Use the actions menu to edit or delete it later.
Step 5: Move to the dashboard
- Open the Dashboard.
- Select your new connection from the dropdown and click Connect to start browsing tables.
That is all it takes to give SQLitePilot a remote server to work with.