> For the complete documentation index, see [llms.txt](https://docs.chassy.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chassy.io/user-guides/fleet-user-guide/enrolling-machines.md).

# Enrolling Machines

To enroll a machine means to register a machine as a member of a fleet. It can be used as a deployment target for your software and automation.

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="https://2391222196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbwi13HaBqeFSGqsnJ8aD%2Fuploads%2FG7gNZqlPDf4mDP6pmZGR%2Fimage.png?alt=media&amp;token=e79b46fb-6c02-4a28-a841-bb65cd0bb6fd" 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="https://2391222196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbwi13HaBqeFSGqsnJ8aD%2Fuploads%2FWhewiXWSKEga9hY3I19r%2Fimage.png?alt=media&amp;token=ed77f68a-1ef8-450b-807e-8afa37629814" 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="https://2391222196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbwi13HaBqeFSGqsnJ8aD%2Fuploads%2FnWBVEK6TYaslkXTe8nZk%2Fimage.png?alt=media&amp;token=d9ef07ca-b4b4-4599-8941-111b4f918e65" 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;