Projects
List and delete your projects, and understand plan limits and name rules
Every deployable app is a project: a globally unique, account-owned name that carries your
deployed app. Projects are created or linked for you by voxal init and
voxal deploy.
voxal projects
voxal projects # list your projects
voxal projects rm <name> # delete a projectThe command has an alias, voxal project. The rm subcommand also accepts remove and
delete.
List
Listing shows your projects and your usage, such as 2/3 projects on the Free plan. It is the
same view as voxal whoami.
Remove
voxal projects rm old-appDeletes the project and frees its name.
Permanent
Deleting a project is permanent and frees its globally unique name for anyone to claim. Make
sure nothing depends on ssh old-app@voxal.sh first.
Plans and limits
Your account carries a plan that caps how many projects you can own.
| Plan | Included apps |
|---|---|
| Free | 3 |
| Pro | 25 (then $1 / app / mo) |
At the limit, creating another project (via init or deploy) fails and tells you to delete
one or upgrade. Check your usage any time with voxal whoami.
Name rules
Project names match /^[a-z0-9][a-z0-9-]{0,62}$/: lowercase letters, digits, and hyphens,
starting with a letter or digit, up to 63 characters. Names are normalized to trimmed
lowercase.
Some names are reserved and cannot be used, including www, api, app, admin, ssh,
voxal, root, dashboard, login, and cli.