# Enrolling Machines

This guide assumes you already have an existing fleet. If you do not have a fleet already, it is best to start with the [Creating a Fleet](/user-guides/fleet-user-guide/creating-a-fleet.md) guide as it will get you up and running.

## How to enroll machines

To enroll new machines, you can navigate to the *Fleet* panel on Chassy console and click *Add Machine* on your intended fleet.

<figure><img src="/files/BcmlISL4OVsbAzDBP9KD" alt="Each fleet has a Add Machine button to enroll a new machine into the fleet."><figcaption></figcaption></figure>

You will first be asked to select or create a new chip. After doing so, you can select *Continue*. If you wish to create a new chip, clicking the select menu will display an option prompting you to do so.

<figure><img src="/files/G0GC17g1RQi41fkmqu1G" alt="Select or add a new chip to assign to the new machines in the fleet."><figcaption></figcaption></figure>

After you have chosen or created a chip for these machines, you will be prompted with instructions for enrolling your machines as members in this fleet.

<figure><img src="/files/Wmy1lb8AhDqK5Py71UTE" alt="Follow the instructions on the screen to prepare and install the Chassy package onto the new machines."><figcaption></figcaption></figure>

### Step 1: Prepare your machines

There are a couple steps crucial to ensuring your machine can be enrolled properly. Carefully ensure the listed requirements are met then move on to step 2.

### Step 2: Install

This next step will provide you with a generated command to be ran on the system to be enrolled. This automated script will account for the bulk of the setup process. Wait a few minutes for it to complete.

{% hint style="info" %}
The `CHASSY_TOKEN` value in this command has a relatively short expiry for security reasons. If it expires while you are still working, worry not. You can generate a new one with the *Generate New Command* button.
{% endhint %}

{% hint style="warning" %}
Be careful not to leak the contents of this command as it contains the token required to register machines to this fleet. It will also expire relatively quickly.
{% endhint %}

### Step 3: Wait for connection

Chassy will display a count of all the machines enrolled to help you keep track of your progress. Once all have connected, you can go ahead and click the *Complete* button.

{% hint style="info" %}
It may take a few minutes for your enrolled machine to appear in the Chassy Console.
{% endhint %}

## Enrolling Firmware Devices

If you are enrolling a firmware or baremetal device on Chassy, refer to the [Enrolling ESP32 Devices](/user-guides/fleet-user-guide/enrolling-machines/enrolling-esp32-devices.md) guide.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chassy.io/user-guides/fleet-user-guide/enrolling-machines.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
