Creating Your First Project
Projects are isolated environments where you manage your database, authentication, and storage. Let's create your first project.
3.1 Access Project Creation
From the dashboard, click the "Create New Project" button or navigate to the Projects section.
Figure 3.1: Dashboard Overview
3.2 Project Creation Form
Fill in the project creation form with the following information:
- Project Name - A descriptive name for your project (up to 50 characters)
- Project Slug - Generated automatically from the name plus a random suffix (for example
my-app-1a2b3c4d); it is not editable on the form. The slug is used in your project URL - Description - Optional. Not shown on the dashboard form; set it through the API or with
wowsql projects create --description - Region - Choose the closest region to your users (see 3.3)
- Deployment Type - Shown as Server Size: Shared (Free plan) or a Dedicated instance (Pro and Scale plans; see 3.4)
- Database Password - Type a strong password or click Generate a password (see 3.5)
The database password must be 8–128 characters with an upper-case letter, a lower-case letter and a digit; symbols are allowed, spaces are not. You can rename the project later.
Figure 3.2: Create Project Form
3.3 Region Selection
Select the region closest to your users for optimal performance:
- Asia Pacific (Mumbai) —
ap-south-1(default) - US East (N. Virginia) —
us-east-1(shown as Coming soon until it is enabled)
Not offered for new projects (the API rejects these with 400 "Unsupported region"):
- US West (Oregon) —
us-west-2 - Europe (Ireland) —
eu-west-1 - Southeast Asia (Singapore) —
ap-southeast-1
A region that is not available yet is shown as Coming soon and cannot be selected.
Figure 3.3: Region Selection
3.4 Deployment Type
Choose your deployment type:
- Shared - Perfect for development and small apps (Free plan)
- Dedicated instance - Your project gets its own VM, billed hourly (Pro and Scale plans):
- Pulse (burstable) - Pro and Scale: Nano, Micro, Small, Medium, Large, XL, 2XL
- Forge (steady compute) - Scale only: Forge Medium, Forge Large and up
| Size | Family / plans | vCPU | RAM | Storage | Included egress / month |
|---|---|---|---|---|---|
| Pulse Nano | Pulse — Pro, Scale | 2 | 512 MB | 10 GB | 25 GB |
| Pulse Micro | Pulse — Pro, Scale | 2 | 1 GB | 20 GB | 50 GB |
| Pulse Small | Pulse — Pro, Scale | 2 | 2 GB | 40 GB | 100 GB |
| Pulse Medium | Pulse — Pro, Scale | 2 | 4 GB | 80 GB | 200 GB |
| Pulse Large | Pulse — Pro, Scale | 2 | 8 GB | 160 GB | 400 GB |
| Pulse XL | Pulse — Pro, Scale | 4 | 16 GB | 320 GB | 800 GB |
| Pulse 2XL | Pulse — Pro, Scale | 8 | 32 GB | 640 GB | 1600 GB |
| Forge Medium | Forge — Scale only | 1 | 4 GB | 80 GB | 250 GB |
| Forge Large | Forge — Scale only | 2 | 8 GB | 160 GB | 500 GB |
| Forge XL | Forge — Scale only | 4 | 16 GB | 320 GB | 1000 GB |
| Forge 2XL | Forge — Scale only | 8 | 32 GB | 640 GB | 2000 GB |
| Forge 4XL | Forge — Scale only | 16 | 64 GB | 1280 GB | 4000 GB |
Every dedicated instance is metered by the hour, including Pulse Nano; the dashboard shows the hourly price for each size. You can modify the deployment type later in the project settings (move a Free shared project to a dedicated instance). To resize a project that already has a dedicated instance, open a support request.
Figure 3.4: Deployment Type Selection
3.5 Project Created
After clicking "Create Project", your project will be provisioned. This may take a few moments.
Save your database password in a password manager or secrets store. If you lose it, reset it from Project Settings → Database password → Reset password.
CLI: wowsql projects create <name> does not send a password, so WoWSQL generates one and the CLI prints it once after the project is created. The --password option is ignored.
Waiting for capacity. Dedicated projects start provisioning right away. If the region you chose has no free capacity, the project status shows Waiting for capacity and a capacity-wait screen appears instead of a spinner. Some requests fail with a capacity error instead of waiting; if that happens, try again or pick another region.
Figure 3.5: Project Being Created
3.6 Project Ready
Once provisioning is complete, you'll see your project dashboard with all available features. Use the Connect menu at the top of the overview to copy your project URL, API key, database connection string or CLI command.
Figure 3.6: Project Successfully Created