.. _fleets:

Create a Fleet
================

This tutorial guides you through creating a fleet in Orchestra's web application. 

.. note:: If you prefer using the command line, see :ref:`calm-ocli-overview`.

1. **Navigate to Fleets:** 
   
   - Open the Orchestra web application.
   - Use the sidebar to navigate to the **Fleets** page.

   If you haven't created any fleets yet, the page will look like this:

   .. image:: images/calm-fleets-empty.png
       :alt: Fleets empty
       :width: 100%
       :align: center

2. **Create a New Fleet:** 
   
   - Click the **Add** button in the top right corner.
   - A "Create a new fleet" dialog will appear.

3. **Configure Fleet Details:**
   
   - **Name:** Enter a clear and descriptive name for your fleet. 
   - **Description (Optional):** Provide a brief description to help you remember the fleet's purpose.
   - **Select Devices:** Choose the devices you want to include in this fleet. You can select multiple devices.

   .. image:: images/calm-create-fleet.png
       :alt: Create a new fleet
       :width: 100%
       :align: center

4. **Save Your Fleet:**
   
   - Click **Create** to save your new fleet.

   You'll see your newly created fleet listed. You can view the devices you've added and their connection status.

   .. image:: images/calm-fleet-created.png
       :alt: Dashboard with a newly created fleet
       :width: 100%
       :align: center

5. **Managing Fleet Variables:**
   
   - Click on the **Variables** tab at the top of the fleet details page.
   - Here, you can define custom variables that will apply to all devices in this fleet. 

   .. note:: Initially, this tab might be empty or show inherited global variables.

   .. image:: images/calm-fleet-variables-empty.png
       :alt: Fleet variable page without any variables
       :width: 100%
       :align: center

6. **Creating a Fleet Variable:** 
   
   - Click the **Add** button in the top right corner.
   - Enter the following:
      - **Key:** A unique identifier for your variable (e.g., `SERVER_PORT`).
      - **Value:** The value you want to assign to the variable (e.g., `8080`).
      - **Description (Optional):**  A brief explanation of the variable's purpose.

   .. image:: images/calm-fleet-create-variable.png
       :alt: Creating a variable
       :width: 100%
       :align: center

   - Click **Create** to save the variable.

   Your new variable will now appear in the list of fleet variables:

   .. image:: images/calm-fleet-variables.png
       :alt: Newly created fleet variable
       :width: 100%
       :align: center


**Next Steps:**

Now that you have a fleet, you can 
:ref:`composition` (your containerized application) add it to this fleet and deploy to all of devices here!