Table of contents

Creating Projects

This guide explains how to create and manage projects on Podstack.

Create a New Project

  1. Navigate to Projects in the sidebar
  2. Click the Create Project button
  3. Fill in the project details:
    • Name: A descriptive name for the project
    • Description: Optional notes about the project’s purpose
  4. Click Create

You’ll be automatically assigned as the Project Admin for any project you create.

Project Settings

To modify a project after creation:

  1. Go to Projects and select the project
  2. Click Settings or the gear icon
  3. Update the name or description
  4. Click Save Changes

Switching Projects

The current project context is shown in the header. To switch projects:

  1. Click the project name in the header
  2. Select a different project from the dropdown
  3. The view updates to show resources from the selected project

Deleting a Project

To delete a project:

  1. Ensure all resources (pods, VMs, storage) in the project are deleted
  2. Go to Project Settings
  3. Scroll to the danger zone
  4. Click Delete Project
  5. 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:

ResourceProject-Scoped
PodsYes
Virtual MachinesYes
NFS VolumesYes
Object Storage BucketsYes
TemplatesYes
SSH KeysNo (account-level)
API TokensNo (account-level)

Next Steps

After creating a project, invite team members to collaborate.