LogoLogo
  • Welcome
  • Getting Started
    • Create a Workspace
    • Join a Workspace
    • Manage your Workspace
  • User Guides
    • Platform User Guide
      • Creating a Platform
      • Creating Chips
    • Fleet User Guide
      • Creating a Fleet
      • Enrolling Machines
        • Enrolling ESP32 Devices
      • Managing a Fleet
    • Workflow User Guide
      • Creating a Workflow
      • Packages and Releases
      • Running Workflows
      • Managing Workflows
  • Operator Guides
    • Generate Chassy Tokens
    • Integrating with GitHub
      • Workflow Run Action
      • Upload Action
  • Tutorials
    • Deploy an Artifact
  • Reference
    • Workflow Components
      • Steps
    • Hardware Hierarchy
    • Integrations
      • AWS
      • GitHub
      • Docker Hub
      • Slack
      • Wasabi
    • Chassy Component for ESP32
Powered by GitBook
On this page
  • How to enroll machines
  • Step 1: Prepare your machines
  • Step 2: Install
  • Step 3: Wait for connection
  • Enrolling Firmware Devices
  1. User Guides
  2. Fleet User Guide

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.

Last updated 1 month ago

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

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.

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.

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.

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.

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.

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.

It may take a few minutes for your enrolled machine to appear in the Chassy Console.

Enrolling Firmware Devices

If you are enrolling a firmware or baremetal device on Chassy, refer to this guide. It uses the ESP32 as an example.

Each fleet has a Add Machine button to enroll a new machine into the fleet.
Select or add a new chip to assign to the new machines in the fleet.
Follow the instructions on the screen to prepare and install the Chassy package onto the new machines.