Creating a managed database
This guide walks you through creating a new managed database on Hostless.
Prerequisites
- A Hostless account
- A payment method (card or credit balance) only if you plan to scale a database above its free ceiling
Create a Database
- Navigate to Databases in the sidebar
- Click Create Database
- Configure your database settings (see below)
- Click Create Database to provision
Configuration Options
Database Name
Choose a unique name for your database. This name will be used in your connection hostname.
Requirements:
- Minimum 3 characters
- Only letters, numbers, hyphens, and underscores allowed
- Must be unique across your account
Database Type
Select your database engine:
- PostgreSQL - Relational database with advanced features and PgBouncer connection pooling
- MySQL - Popular relational database for web applications
- MongoDB - Document-oriented NoSQL database
- Redis - In-memory data store for caching, sessions, and queues
Version
Choose a version for your database. Available versions depend on the database type:
PostgreSQL: 11, 12, 13, 14, 15, 16, 17, or latest
MySQL: 5.7, 8.0, 8.4, 9.0, or latest
MongoDB: 4.4, 5.0, 6.0, 7.0, 8.0, or latest
Redis: 6.x, 7.x, or latest
Selecting "latest" will use the most recent stable version.
Resource Configuration
Configure the compute and storage resources for your database:
| Resource | Range | Default |
|---|---|---|
| CPU | 0.1 - 16 cores | 0.1 cores |
| Memory | 256 MB - 16 GB | 512 MB |
| Storage | 256 MB - 50 GB | 256 MB |
Note: New databases default to 0.1 vCPU, 512 MB memory, and 256 MB storage. CPU and memory draw on your account's shared free allowance of 1 vCPU and 1 GB, and the first 1 GB of storage per database is free and never pooled. See Database Billing.
Link to an App (Optional)
You can automatically link your new database to an existing app during creation:
- Check Link to an app
- Select the app from the dropdown
- (Optional) Customize the environment variable name (default:
DATABASE_URL)
When linked, the database connection string is automatically injected into your app's environment variables. The app will be redeployed to apply the changes.
Payment requirement
You can create unlimited databases within the free ceiling. A larger database requires a card or positive credit balance in the current project. Without one, Hostless blocks the request and identifies the exceeded axis.
After Creation
Once your database is created, you'll be redirected to the database detail page where you can:
- View connection details
- Monitor database status
- Scale resources (a payment method is required only above the free ceiling)
- Delete the database
The database will show a DEPLOYING status while being provisioned. Once ready, the status changes to RUNNING.