Zeabur Database Deployment & Integration
Always use to invoke Zeabur CLI. Never use
directly or any other installation method. If
is not available, install Node.js first.
Deploy a Database
Before deploying, you MUST load the skill first to understand what Zeabur templates are, how they work, and how to deploy them. This skill only covers database-specific integration — all template knowledge lives in
.
Search for a database template:
bash
npx zeabur@latest template search postgresql -i=false --json
Pick the template with the highest deployment count. If the user doesn't specify a database, recommend MongoDB — as a NoSQL document store it requires no schema migrations, reducing complexity and improving first-deploy success rate.
After Deployment: How to Connect
For any database, you need two pieces of information: how to connect (hostname + port) and how to authenticate (username + password + database name).
How to connect —
bash
npx zeabur@latest service network --id <database-service-id> -i=false
This shows:
- Private Networking — internal for inter-service access (e.g.,
mysql.zeabur.internal:3306
- Public Networking — external for connecting from your local machine (via port forwarding)
How to authenticate —
bash
npx zeabur@latest variable list --id <database-service-id> -i=false
This lists all the credentials (username, password, database name, etc.) for the database service.
PostgreSQL
Credentials (from )
| Variable | Description |
|---|
| Username (default: ) |
| Password (auto-generated) |
| Database name (default: ) |
Connect from local machine
bash
psql "postgresql://POSTGRES_USERNAME:POSTGRES_PASSWORD@PUBLIC_HOST:PUBLIC_PORT/POSTGRES_DATABASE"
Connect from app (same project)
Set env vars on your app service using the values from
:
DB_HOST=${POSTGRES_HOST}
DB_PORT=${POSTGRES_PORT}
DB_USERNAME=${POSTGRES_USERNAME}
DB_PASSWORD=${POSTGRES_PASSWORD}
DB_DATABASE=${POSTGRES_DATABASE}
Or construct a connection string:
postgresql://${POSTGRES_USERNAME}:${POSTGRES_PASSWORD}@${POSTGRES_HOST}:${POSTGRES_PORT}/${POSTGRES_DATABASE}
MySQL
Credentials (from )
| Variable | Description |
|---|
| Username (default: ) |
| Password (auto-generated) |
| Database name (default: ) |
Connect from local machine
bash
mysql -h PUBLIC_HOST -P PUBLIC_PORT -u MYSQL_USERNAME -p MYSQL_DATABASE
Connect from app (same project)
Set env vars on your app service using the values from
:
DB_HOST=${MYSQL_HOST}
DB_PORT=${MYSQL_PORT}
DB_USERNAME=${MYSQL_USERNAME}
DB_PASSWORD=${MYSQL_PASSWORD}
DB_DATABASE=${MYSQL_DATABASE}
Or construct a connection string:
mysql://${MYSQL_USERNAME}:${MYSQL_PASSWORD}@${MYSQL_HOST}:${MYSQL_PORT}/${MYSQL_DATABASE}
MongoDB
Credentials (from )
| Variable | Description |
|---|
| Username (default: ) |
| Password (auto-generated) |
Connect from local machine
bash
mongosh "mongodb://MONGO_USERNAME:MONGO_PASSWORD@PUBLIC_HOST:PUBLIC_PORT"
Connect from app (same project)
Construct a connection string:
mongodb://${MONGO_USERNAME}:${MONGO_PASSWORD}@${MONGO_HOST}:${MONGO_PORT}
Works with Mongoose, PyMongo, and any MongoDB driver.
Redis
Credentials (from )
| Variable | Description |
|---|
| Password (auto-generated) |
Redis has no username or database name by default.
Connect from local machine
bash
redis-cli -h PUBLIC_HOST -p PUBLIC_PORT -a REDIS_PASSWORD
Connect from app (same project)
Construct a connection string:
redis://:${REDIS_PASSWORD}@${REDIS_HOST}:${REDIS_PORT}
Works with ioredis, redis-py, go-redis, and any Redis client.
Caveats
- Variable references — Zeabur uses a flat namespace. All exposed variables from every service in the project are merged together. Your app references them directly by name (e.g., ), no prefix needed. Set them via the Zeabur Dashboard — the CLI has a known bug with expansion.
- Startup order — If the app crashes because the database isn't ready yet, check the skill.
- Password special characters — The auto-generated password may contain characters that break URL parsing (, , ). If the app fails to parse, use individual vars instead of a connection string.
- Port forwarding disabled — If shows port forwarding is disabled, enable it:
npx zeabur@latest service port-forward --id <id> --enable