Deploy Databases
Deploy pre-configured databases (PostgreSQL, MySQL, MariaDB, MongoDB) from QuickStack templates.
QuickStack provides pre-configured templates for popular databases. Templates set up persistent storage, secure defaults, and environment variables automatically.
Available templates
- PostgreSQL — advanced open-source relational database
- MySQL — popular open-source relational database
- MariaDB — enhanced, drop-in replacement for MySQL
- MongoDB — document database for modern apps
- Redis — in-memory key-value store for caching and messaging
Deployment steps
1. Create the database
- Open your project's Project Canvas and click Create App → Database, or right-click an empty spot on the canvas and choose Create Database.
- Select the database type.
- Configure the instance:
- App Name — a unique name (e.g.
my-postgres-db) - Password — use the generate button for a strong random password
- App Name — a unique name (e.g.
- Click Create. QuickStack provisions the volume, deploys the container, and configures internal networking.
Connecting to your database
Internal access (recommended)
Other apps in the same project connect via the service hostname:
- Hostname:
svc-<app-id>.<project-id>.svc.cluster.local(copy the exact value from the database's Settings → Networking → Network Policy rule actions → Copy internal hostname) - Port: standard port for the engine (PostgreSQL:
5432, MySQL/MariaDB:3306, MongoDB:27017, Redis:6379) - Credentials: shown in the DB Access tab in the app drawer
Allow the connection first Database templates restrict internet egress and use explicit network policy rules. Add an ingress rule for the calling app on the database's Settings → Networking section (or an egress rule on the app) before connecting. See Networking.
Clipboard copy Copying credential values requires your QuickStack instance to be served over HTTPS.
External access (not recommended)
By default, databases are not exposed to the internet. If you need local access for development, you can assign a public domain in the database's Settings → Networking section.
Security Warning Exposing databases to the public internet is a security risk. Only do this for testing purposes.
Environment variables in templates
Database templates auto-configure environment variables (e.g. POSTGRES_PASSWORD, MYSQL_ROOT_PASSWORD). Do not modify these manually — it may break the pre-configured connection.