Mage AI

Development2048MB+ RAM

Modern data pipeline and orchestration tool for ML workflows

Download Server Compass Install Mage AI to server

aimldata-pipelineorchestrationetl

Deploy Mage AI in 3 Steps

Connect Your VPS

Add your server credentials to Server Compass

Select Mage AI

Choose from our template library

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required

Step-by-step deployment guide

Deploy Mage AI on a VPS with Server Compass

Use the Mage AI template in Server Compass to deploy a modern data pipeline and orchestration tool for ML workflows on your VPS, then verify the web UI in a browser.

About 10 minutesBrowser verified

Step 1

Open the server Apps tab

Select the tutorial-vps 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 Mage AI app

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

Step 3

Search for Mage AI

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

Searching for Mage AI in the Server Compass template picker

Step 4

Select the Mage AI template

Choose the Mage AI template. Server Compass fills the Mage service, PostgreSQL database, generated database password, project name, persistent pipeline volume, and web port.

Mage AI template selected in Server Compass

Step 5

Review the Mage AI settings

Confirm the app name and compose services. In this run, the app was named mage-ai-demo and used host port 6789.

Reviewing Mage AI project settings and compose services

Step 6

Deploy Mage AI

Review the generated compose settings, confirm the web port is available, and click Deploy.

Reviewing Mage AI environment variables and port before deployment

Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Mage AI image, starts the container, and verifies the stack.

Server Compass deploying the Mage AI template on the VPS

Step 8

Confirm Mage AI is running

After deployment finishes, return to the Apps tab and confirm the Mage AI app is marked Running with its application URL available.

Mage AI template running in the Server Compass Apps tab

Step 9

Open Mage AI in the browser

Click Open Application or open the application URL in a browser. The Mage AI sign-in screen confirms the pipeline orchestration service is reachable.

The deployed Mage AI sign-in screen loaded in a browser

After Mage AI Opens

Do not expose Mage AI directly to the public internet without HTTPS and an additional access-control layer.
Use a VPN, IP allowlist, firewall rule, or authenticated reverse proxy for production access.
Store data source credentials carefully and use least-privilege users for pipeline connections.
Back up the Mage project volume and PostgreSQL database before upgrades.
Keep the Mage AI image updated for security, connector, and scheduler fixes.

Verified Result

The Mage AI sign-in screen loaded successfully in a browser.

Download Server Compass Docs

Mage AI deployment questions

What does the Mage AI template deploy?

It deploys the Mage AI container with a persistent `/home/src` project volume plus a PostgreSQL database for metadata and generated database credentials.

Which port did the tutorial use?

The tutorial used host port 6789, which maps to the Mage AI web UI on container port 6789.

Why does the browser verification stop at the first web UI screen?

A fresh Mage AI deployment is considered reachable when the web UI loads. The tutorial does not create pipelines, connect external data sources, or publish the generated database password.

Should this become a blog post?

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

Why Self-Host Mage AI?

Mage AI is a modern data pipeline and orchestration tool designed for ML workflows. Self-hosting ensures your data pipelines — which often process sensitive business data — run entirely within your infrastructure. Unlike hosted ETL services that charge per data row, Mage has no usage-based pricing.

Build data pipelines with a hybrid notebook/IDE interface

Process sensitive data without sending it to third-party services

No per-row or per-run pricing — unlimited pipeline executions

Native integration with dbt, Spark, and popular ML frameworks

Built-in orchestration with scheduling, dependencies, and monitoring

Mage AI vs Alternatives

Mage AI vs Airflow

Airflow is powerful but complex to operate. Mage provides a modern UI with real-time development and simpler configuration.

Mage AI vs Fivetran

Fivetran charges per data row. Self-hosted Mage processes unlimited data with zero platform fees.

Mage AI vs Prefect Cloud

Prefect Cloud is a managed service with usage limits. Mage runs entirely on your server with no external dependencies.

Why Deploy Mage AI with Server Compass?

Server Compass deploys Mage AI with persistent storage for your pipelines and data. It handles the Docker volume mapping so your pipeline code, schedules, and metadata survive container updates.

Download Server Compass

After Deployment

After deploying Mage AI with Server Compass, complete these steps to finish setup

Access the Mage UI

Create your first pipeline

Configure data sources and transformations

Need help? Check out our documentation for detailed guides.

Mage AI FAQ

Common questions about self-hosting Mage AI

How do I deploy Mage AI with Server Compass?

Simply download Server Compass, connect to your VPS, and select Mage AI 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 Mage AI?

Mage AI requires a minimum of 2048MB RAM. We recommend a VPS with at least 4096MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing Mage AI data?

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

How do I update Mage AI to the latest version?

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

Is Mage AI free to self-host?

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

Related Templates

View all Development

PocketBase

Open-source backend in a single file with realtime database, auth, and file storage

Appwrite

Open-source backend-as-a-service - self-hosted Firebase alternative

Parse Server

Open-source backend framework with dashboard

Supabase

Full Supabase self-hosted with Kong, GoTrue Auth, Realtime, and Studio

Ready to Self-Host Mage AI?

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

Download Server Compass