Getting Started

Introduction to ServerPlane Creating Your Account Dashboard Overview Quickstart: First Server & App

Servers

Connecting a Server Server Overview Managing Services Alert Rules & Monitoring Server Settings SSH and Permissions SSH Keys

Apps

Deploying an Application Deploying a WordPress Application Deploying a Node.js Application Deploying a Python Application Deploying a Docker Application Deploying a Static Site App Detail Page Domains & SSL Environment Variables PHP Configuration App Logs Load Balancing Deleting an Application App Recipes

Databases

Creating a Database Managing Database Users Browsing Data & Running Queries Export & Import Linking Databases to Apps Database Discovery Database Replication

Backups

Backup Destinations Creating a Backup Managing Backups Restoring from a Backup

File Management

File Manager File Operations SFTP Accounts

Git & CI/CD

Connecting Your GitHub Account Git Deployments Auto-Deploy on Push Deployment History & Rollback

Teams

Managing Teams Team Members Whitelabel Branding

Settings

Profile and Security Audit Log

Web Terminal

Web Terminal

Reference

Frequently Asked Questions Troubleshooting Glossary

Linking Databases to Apps

Each app in ServerPlane has a Database tab where you can associate one or more databases. Linking a database to an app is a logical association — it does not change any configuration on the server, but it helps you organize which databases belong to which apps.

Viewing Linked Databases

  1. Open your app's detail page and go to the Database tab.
  2. Any databases currently linked to the app are shown as cards with the database name, type badge (MariaDB/PostgreSQL/MongoDB), size, and user count.

Each card has two actions:

  • View Details — Opens the full database detail page (Browse, Users, Query, Export/Import tabs).
  • Unlink — Removes the association between the database and the app. The database itself is not deleted.

Linking an Existing Database

If you already have a database on the same server, you can link it to the app.

  1. In the Database tab, click Link Existing Database.
  2. A dropdown shows all unlinked databases on the app's server. Select one.
  3. Click Link Database.

Only databases on the same server as the app and not already linked to another app are shown in the dropdown. If no unlinked databases are available, you will see a message with a link to create a new one instead.

Creating a New Database for an App

You can create a database directly from the app's Database tab. The server is pre-selected to match the app's server.

  1. In the Database tab, click Create New Database.
  2. Fill out the form:
    • Database Type — MariaDB, PostgreSQL, or MongoDB.
    • Database Name — Name for the new database.
    • Charset / Collation — Available for MariaDB and PostgreSQL. Defaults are pre-filled.
    • Database User (optional) — Check Create user and fill in username and password, or click Generate.
  3. Click Create Database.

The new database is automatically linked to the app after creation. A progress panel shows the installation and creation steps. After completion, a summary screen displays the credentials.

Unlinking a Database

  1. In the Database tab, click Unlink on the database card.
  2. Confirm the dialog.

Unlinking removes the association only. The database, its data, and its users remain on the server. You can re-link it later or link it to a different app.

Notes

  • An app can have multiple linked databases (e.g., a MariaDB for the main data and a MongoDB for analytics).
  • To delete a database entirely, navigate to it from the Databases section in the sidebar and use the Danger Zone tab.

Previous

Export & Import

Next

Database Discovery