> ## 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](https://www.qovery.com/docs/configuration/organization/members-rbac.md).

## Prerequisites

* An existing organization in Qovery

## Create a New Project

**1. Open Organization Overview**

Go to your organization overview in the [Qovery Console](https://console.qovery.com)

**2. Create Project**

Click the **New Project** button

![Project Creation](https://mintcdn.com/qovery/ziWdn5St6rf4bcBc/images/configuration/project/project_creation.png?fit=max\&auto=format\&n=ziWdn5St6rf4bcBc\&q=85\&s=5fd6ebe4ab2efe49657fbc51855a185c)

**3. Configure Project**

Enter the following information:

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

**4. Save**

Click **Create** to finalize the project creation

## Edit Project General Information

To update project details:

**1. Access Settings**

Open the project settings page

**2. Select Project**

Choose the project you want to edit

**3. Open General Section**

Navigate to the **GENERAL** section

**4. Update and Save**

Modify the name or description and save your changes

![Project Update](https://mintcdn.com/qovery/ziWdn5St6rf4bcBc/images/configuration/project/project_update.png?fit=max\&auto=format\&n=ziWdn5St6rf4bcBc\&q=85\&s=4a9cb7a6e5fd746f7cf205f9d065e46b)

## 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

To delete a project:

**1. Access Project Settings**

Open the project settings page

**2. Select Project**

Choose the project you want to delete

**3. Navigate to Danger Zone**

Go to the **DANGER** section

**4. Delete Project**

Click the **Delete Project** button

![Project Delete](https://mintcdn.com/qovery/ziWdn5St6rf4bcBc/images/configuration/project/project_delete.png?fit=max\&auto=format\&n=ziWdn5St6rf4bcBc\&q=85\&s=94ed4d7f7f710410153331677a0de363)

**5. Confirm Deletion**

Type the project name to confirm and complete the deletion

## Related Topics

> [card] [Organization](https://www.qovery.com/docs/configuration/organization.md)
>
> Learn about organization configuration

> [card] [Environment](https://www.qovery.com/docs/configuration/environment.md)
>
> Configure environments within projects

> [card] [Members & RBAC](https://www.qovery.com/docs/configuration/organization/members-rbac.md)
>
> Manage access control for projects

> [card] [CLI: Project Commands](https://www.qovery.com/docs/cli/commands/project.md)
>
> Manage projects using the Qovery CLI


## Related topics

- [Delete a project](https://www.qovery.com/docs/api-reference/project-main-calls/delete-a-project.md)
- [qovery project](https://www.qovery.com/docs/cli/commands/project.md)
- [Edit a project](https://www.qovery.com/docs/api-reference/project-main-calls/edit-a-project.md)
- [Create a project](https://www.qovery.com/docs/api-reference/projects/create-a-project.md)
- [List projects](https://www.qovery.com/docs/api-reference/projects/list-projects.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.