---
updatedAt: 2025-08-27T17:16:08.000Z
agentTools:
  projectIndex: https://documentation.bunnyshell.com/llms.txt
---

# Create the Environment

## Create a Project

Before an environment can be created, you will need a Project. Projects can include one or several environments and allow you to test your applications and their individual features.

For example, you can set up a project for every app you're currently developing, each project containing environments for staging, development, QA, production etc.

Set up your first Project by following the steps below:

1. Click the **Create project** button in the Bunnyshell interface.

2. For this particular example, let's name your Project **Getting Started**.

3. Click the **Create project** button once more and you're all set!

Additionally you can find out more by accessing [the Projects page](projects).

 

## Create an environment

You have your first Project. Now let's go ahead and create an **Environment** in it.

> 📘 Definition
>
> An Environment is a user-defined group that brings together applications and all of the services and databases those applications require, running within a namespace.

There are two types of Environments that can be created in Bunnyshell:

* **Primary environments**. These are manually-created environments and are not destroyed automatically. Typically they are for more traditional staging or production workloads.

* **Ephemeral environments**. Designed to be close replicas of production environments, ephemerals can be created on-demand or automatically only based on existing primary environments.

In this case, we'll create a primary environment:

1. Select your Project from the main Bunnyshell interface and click **Create environment**.
2. Let's name our Environment **Bunnyshell-Books**.

Congratulations! You now have your first project and your first environment.

For more information on this topic, visit [our Environments page](environments).