> ## Documentation Index
> Fetch the complete documentation index at: https://www.qovery.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Project

> Configure and manage projects to group environments

## Overview

A project allows you to group together a set of environments with the objective to run the same application. Projects are automatically created when you create a new organization and support role-based access control through [Qovery's RBAC system](/configuration/organization/members-rbac).

## Prerequisites

* An existing organization in Qovery

## Create a New Project

<Steps>
  <Step title="Open Organization Overview">
    Go to your organization overview in the [Qovery Console](https://console.qovery.com)
  </Step>

  <Step title="Create Project">
    Click the **New Project** button

    <img src="https://mintcdn.com/qovery/ziWdn5St6rf4bcBc/images/configuration/project/project_creation.png?fit=max&auto=format&n=ziWdn5St6rf4bcBc&q=85&s=5fd6ebe4ab2efe49657fbc51855a185c" alt="Project Creation" width="2784" height="1830" data-path="images/configuration/project/project_creation.png" />
  </Step>

  <Step title="Configure Project">
    Enter the following information:

    * **Name**: A descriptive name for your project
    * **Description**: (Optional) Brief description of the project's purpose
  </Step>

  <Step title="Save">
    Click **Create** to finalize the project creation
  </Step>
</Steps>

## Edit Project General Information

To update project details:

<Steps>
  <Step title="Access Settings">
    Open the project settings page
  </Step>

  <Step title="Select Project">
    Choose the project you want to edit
  </Step>

  <Step title="Open General Section">
    Navigate to the **GENERAL** section
  </Step>

  <Step title="Update and Save">
    Modify the name or description and save your changes

    <img src="https://mintcdn.com/qovery/ziWdn5St6rf4bcBc/images/configuration/project/project_update.png?fit=max&auto=format&n=ziWdn5St6rf4bcBc&q=85&s=4a9cb7a6e5fd746f7cf205f9d065e46b" alt="Project Update" width="3164" height="2070" data-path="images/configuration/project/project_update.png" />
  </Step>
</Steps>

## Delete a Project

<Warning>
  Deleting a project is a **non-recoverable operation**. This will permanently delete:

  * All environments within the project
  * All running applications and their data
  * All databases and their data
  * All configuration and secrets
  * All deployment history
</Warning>

To delete a project:

<Steps>
  <Step title="Access Project Settings">
    Open the project settings page
  </Step>

  <Step title="Select Project">
    Choose the project you want to delete
  </Step>

  <Step title="Navigate to Danger Zone">
    Go to the **DANGER** section
  </Step>

  <Step title="Delete Project">
    Click the **Delete Project** button

    <img src="https://mintcdn.com/qovery/ziWdn5St6rf4bcBc/images/configuration/project/project_delete.png?fit=max&auto=format&n=ziWdn5St6rf4bcBc&q=85&s=94ed4d7f7f710410153331677a0de363" alt="Project Delete" width="3164" height="2070" data-path="images/configuration/project/project_delete.png" />
  </Step>

  <Step title="Confirm Deletion">
    Type the project name to confirm and complete the deletion
  </Step>
</Steps>

## Related Topics

<CardGroup cols={2}>
  <Card title="Organization" href="/configuration/organization">
    Learn about organization configuration
  </Card>

  <Card title="Environment" href="/configuration/environment">
    Configure environments within projects
  </Card>

  <Card title="Members & RBAC" href="/configuration/organization/members-rbac">
    Manage access control for projects
  </Card>

  <Card title="CLI: Project Commands" href="/cli/commands/project">
    Manage projects using the Qovery CLI
  </Card>
</CardGroup>