Creating a Database
This guide walks you through creating a new managed database on Hostless.
Prerequisites
- A Hostless account
- For multiple databases or custom resources, an Unleashed subscription
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
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
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 - 1 cores | 0.1 cores |
| Memory | 256 MB - 16 GB | 512 MB |
| Storage | 256 MB - 50 GB | 256 MB |
Note: FREE tier databases use fixed resources (0.1 vCPU, 512 MB memory, 256 MB storage) and cannot be customized.
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.
FREE Tier Limitations
On the FREE tier:
- You can create 1 database per account
- Resources are fixed and cannot be scaled
- To create additional databases or scale resources, upgrade to Unleashed
If you've already created a free database, the button will change to Upgrade to Unleashed.
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 (Unleashed only)
- Delete the database
The database will show a DEPLOYING status while being provisioned. Once ready, the status changes to RUNNING.