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, VMs, 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.
Project-Scoped Resources
When you create resources, they belong to the currently selected project:
| Resource | Project-Scoped |
|---|---|
| Pods | Yes |
| Virtual Machines | 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.