Back to all templates
MariaDB logo

MariaDB

Database512MB+ RAM

Community-developed MySQL fork with enhanced features

databasesqlrelationalmariadbmysql-compatible

Deploy MariaDB in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select MariaDB

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy MariaDB on a VPS with Server Compass

Use the MariaDB template in Server Compass to deploy a persistent MariaDB database on your VPS, then verify it from the app detail and DB Admin view.

About 5 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select your VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating a MariaDB app
2
Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template
3
Step 3

Search for MariaDB

Use the template picker search to find MariaDB in the Server Compass template catalog.

Searching for MariaDB in the Server Compass template picker
4
Step 4

Select the MariaDB template

Choose the MariaDB template. Server Compass fills the Docker image, persistent volume, database name, database user, and generated credentials.

MariaDB template selected in Server Compass
5
Step 5

Review the generated database settings

Confirm the app name, host port, database name, username, and generated passwords. In the pilot run, the app was named mariadb-demo and the host port was changed to 13307 to avoid conflicts.

Reviewing MariaDB deployment settings and generated credentials
6
Step 6

Deploy MariaDB

Review the final settings, click Deploy Now, and let Server Compass create the MariaDB container and persistent volume on the VPS.

Reviewing MariaDB settings before clicking Deploy Now
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass prepares the project, pulls the Docker image, starts the container, and checks the service status.

Server Compass deploying the MariaDB template on the VPS
8
Step 8

Confirm the database is running

After deployment finishes, return to the Apps tab and confirm the MariaDB app is marked Running with its database connection section available.

MariaDB template running in the Server Compass Apps tab
9
Step 9

Open DB Admin to verify access

Open the MariaDB app details and switch to DB Admin. Seeing the DB Admin screen return OK confirms Server Compass can reach the deployed database service without exposing the generated passwords.

MariaDB DB Admin page showing the deployed database is reachable

After MariaDB Opens

  • Copy the masked external connection string only when you are ready to connect from a trusted client.
  • Use DB Admin, the mariadb/mysql CLI, or your application container to create schemas and tables.
  • Keep the generated root and app passwords in Server Compass and avoid pasting them into screenshots or docs.
  • Restrict external access later if the database only needs to be reachable from Docker apps on the same server.

Verified Result

Server Compass showed one running MariaDB container, host port 13307 mapped to container port 3306, and the DB Admin page returned OK for the deployed app database.

MariaDB deployment questions

What does the MariaDB template deploy?

It deploys the official MariaDB Docker image with persistent storage, an initial database, an app user, and generated passwords.

Which port did the pilot use?

The pilot used host port 13307 mapped to MariaDB port 3306 to avoid conflicts with any existing database service.

Should this become a blog post?

No. The deployment guide should live on the MariaDB template detail page and be linked from the reusable template deployment docs page.

Terminal Deployment

MariaDB CLI Deployment

Deploy MariaDB the traditional way with SSH and Docker Compose.

1

Connect to Your Remote Server

Begin by establishing a secure connection to your server through the terminal.

terminal
# Access your VPS
ssh root@YOUR_SERVER_IP

# With SSH key authentication
ssh -i ~/.ssh/your-private-key root@YOUR_SERVER_IP

First time? Ensure Docker is installed first: curl -fsSL https://get.docker.com | sh

2

Set Up Your App Folder

Create a dedicated folder for your application files.

terminal
# Create and navigate to project directory
mkdir -p ~/apps/mariadb
cd ~/apps/mariadb
3

Set Up Docker Compose

Create the following docker-compose.yml in your project directory:

docker-compose.yml
services:
  mariadb:
    image: mariadb:11
    ports:
      - "3306:3306"
    environment:
      - MARIADB_ROOT_PASSWORD=<your-root-password>
      - MARIADB_DATABASE=app
      - MARIADB_USER=app
      - MARIADB_PASSWORD=<your-password>
    volumes:
      - mariadb_data:/var/lib/mysql
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "healthcheck.sh --connect --innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  mariadb_data:
Deployment Settings
PORTHost port(default: 3306)
ROOT_PASSWORDRoot password
DATABASEDatabase name(default: app)
USERDatabase user(default: app)
PASSWORDUser password
4

Spin Up the Stack

Run Docker Compose to launch your application.

terminal
# Launch the stack
docker compose up -d

# Verify container status
docker compose ps

# Follow the logs
docker compose logs --follow
5

Open the Application Port

Configure UFW to allow traffic to your application.

terminal
# Allow the application port through firewall
sudo ufw allow 3306/tcp
sudo ufw reload

# Access your app at:
# http://your-server-ip:3306
Skip the Terminal

Make it simple with Server Compass.

Server Compass makes deploying MariaDB effortless. Visual setup, one-click deploy, done.

  • No terminal required
  • Point-and-click setup
  • Auto SSL certificates
  • Rolling deployments
  • Health monitoring
  • Instant rollbacks
Download Server Compass$29 one-time • Lifetime license

MariaDB FAQ

Common questions about self-hosting MariaDB

How do I deploy MariaDB with Server Compass?

Simply download Server Compass, connect to your VPS, and select MariaDB from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for MariaDB?

MariaDB requires a minimum of 512MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing MariaDB data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard MariaDB backup and restore procedures.

How do I update MariaDB to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest MariaDB image will be pulled and deployed with zero downtime.

Is MariaDB free to self-host?

MariaDB is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Ready to Self-Host MariaDB?

Download Server Compass and deploy MariaDB to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass