Database Discovery

If your server already has databases that were created outside of ServerPlane (e.g., manually or by another tool), you can discover and import them into the panel so they appear in your database list.

How Discovery Works

ServerPlane scans the server for each installed database engine (MariaDB, PostgreSQL, MongoDB) and lists all databases. System databases are automatically excluded. The results are compared against databases already tracked by ServerPlane, and only untracked databases are shown.

Running a Discovery Scan

1. Navigate to Databases in the sidebar.
2. Click the Discover button in the top-right corner.
3. A panel opens at the top of the page. Select a Server from the dropdown.
4. Click Scan Server.
5. Wait for the scan to complete. ServerPlane checks all installed database engines on that server.

Scan Results

After scanning, you will see one of the following:

• Untracked databases found — A list of databases grouped by type, each with a checkbox. The type badge (MariaDB, PostgreSQL, or MongoDB) is shown next to each database name.
• No new databases found — All databases on the server are already tracked by ServerPlane.
• Error — The scan failed. This typically means the agent could not reach a database engine. Check that the engine is running.

Engines that are not installed on the server are silently skipped — no error is shown for missing engines.

Importing Discovered Databases

1. Check the boxes next to the databases you want to import. Use Select All to check everything at once.
2. Click Import N Selected (where N is the count of selected databases).
3. The databases are added to ServerPlane's records with default charset and collation settings.

Imported databases appear immediately in your database list and can be managed like any other database (browse data, manage users, export/import, etc.).

What Gets Imported

Discovery imports only the database metadata (name, type, server association). It does not:

• Create or modify any database users.
• Change any data or configuration on the server.
• Read or store database contents.

To manage users for a discovered database, open it and go to the Users tab to add users manually.

Notes

• Discovery only finds databases from engines that are already installed. If you need to manage a database type that is not installed, create a new database of that type first (the engine will be installed automatically).
• System databases are filtered out automatically (e.g., information_schema, performance_schema, mysql, sys for MariaDB; template0, template1, postgres for PostgreSQL; admin, config, local for MongoDB).
• You can run discovery multiple times. Databases that are already tracked are never duplicated.