Creating Projects
This guide explains how to create and manage projects on Podstack.
Create a New Project
- Navigate to Projects in the sidebar
- Click the Create Project button
- Fill in the project details:
- Name: A descriptive name for the project
- Description: Optional notes about the project’s purpose
- Click Create
You’ll be automatically assigned as the Project Admin for any project you create.
Project Settings
To modify a project after creation:
- Go to Projects and select the project
- Click Settings or the gear icon
- Update the name or description
- Click Save Changes
Switching Projects
The current project context is shown in the header. To switch projects:
- Click the project name in the header
- Select a different project from the dropdown
- The view updates to show resources from the selected project
Deleting a Project
To delete a project:
- Ensure all resources (pods, storage) in the project are deleted
- Go to Project Settings
- Scroll to the danger zone
- Click Delete Project
- Confirm the deletion
Warning: Project deletion is permanent and cannot be undone.
Default Project
New accounts have a default project created automatically. You can rename it or create additional projects as needed.
Billing Ownership
Each project has a billing owner who is charged for all resource usage within the project. By default, the project creator is the billing owner.
Transferring Billing
To transfer billing responsibility to another project member:
- Go to Project Settings
- Navigate to the Billing section
- Click Transfer Billing
- Select the new billing owner from the member list
- Confirm the transfer
The new billing owner must be an active member of the project.
Project-Scoped Resources
When you create resources, they belong to the currently selected project:
| Resource | Project-Scoped |
|---|---|
| Pods | Yes |
| NFS Volumes | Yes |
| Object Storage Buckets | Yes |
| Templates | Yes |
| SSH Keys | No (account-level) |
| API Tokens | No (account-level) |
Next Steps
After creating a project, invite team members to collaborate.