# Get Started

#### Create a Workspace

 A workspace is the top-level location for all workflows for your organization.

<figure><img src="/files/hqFhaLGbOQq2jBYoPDXx" alt=""><figcaption></figcaption></figure>

Choose a workplace name and then select next.

#### Invite Teammates

<figure><img src="/files/g800lJoJbDtSSid5FKBG" alt=""><figcaption></figcaption></figure>

Invite teammates from your organization into your workspace. They will each create their own account. The platform provides administrators with flexible workspace permissions. You can tailor access levels for each user, ensuring they only interact with the workspaces relevant to their role and responsibilities.

#### Set up Github Integrations

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd6PngZFg-uU3MRQ-I03iXlDSG_R4TCBOAicddroaCqc9ZmJv1OqAllQlpFQ-cm5g1LlIMsCaf5lK8Uy8Uqj7cYCivxE7OYAQsehiJRBiIrPE24e9auiNx4QeRAnBEWCq8crMMadzL0hSj5F7KRQpDvGbw?key=CrjAmK76ZdHhNlRMtvcEMw" alt=""><figcaption></figcaption></figure>

Click on the Integrations Page button to set up GitHub integrations, and once you've added and integrated Chassy with your CI systems, return here and continue on to create your first workflow.

### Create your first Workflow

For more information on what workflows are, see the [Workflows, Steps and Tasks section](/reference/workflow-components.md) of the user guide.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd-gmJrJpjI_Jav8XOIPuCvbQyNmN2gbXmgMebszBOqVdBas9P8FVkLRco8oKfHlJe4nbIap8U_iQEehDEiQwQTSvpy15dbIrXgJcHgdkLQpvBjDTL9KZvhV-VSctaKtu3yXzgV73MM2nWGua0a2cXHFhUp?key=CrjAmK76ZdHhNlRMtvcEMw" alt=""><figcaption></figcaption></figure>

To create your first workflow, click on the Create Workflow button in the center of the dashboard.<br>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfV0mtWUWKORNfyDVJd-dJmd0IDelH0JhFoJOjiCP1fXxDM83i877QBVkLyakPrK5jef_WdOVVCegjwIAICvI5NlPA0UMDe082DISiRAzbjHS1L7BVnMs3UPOTJshmCXkDCiihsc6khKzLNXMrcWYP6MrQY?key=CrjAmK76ZdHhNlRMtvcEMw" alt=""><figcaption></figcaption></figure>

Under Workflow Name, enter a name that describes the workflow you're trying to create. A helpful description can be entered in the description field.\
Fill out the notification sectioni al s if you'd like to be notified upon workflow completions. For configuring Slack notifications, refer to the [Slack configuration guide](/reference/integrations/slack.md).<br>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeixgRxsX9sMUFAkRdPZXXk_WrQNj9IGjiBiYuSbP422hyLMI9ykUu76wfCA8896oEcDGvanv2rt-jyxjR9XWQdtn8tYaNyC2MPKSP1dq_lCXFXpU3sT7HFyCPVOBMG2-Z4PagPzEHK19tqCb5AvOCjR_si?key=CrjAmK76ZdHhNlRMtvcEMw" alt=""><figcaption></figcaption></figure>

This is the crucial stage of the workflow process where you can add or modify steps to your workflow. The top-middle section presents a graphical representation of your workflow, showcasing all the steps involved. The current step is prominently highlighted in yellow, making it easily identifiable.<br>

The "Details" tab, located on the middle-bottom of the screen, displays the configuration options and settings for the current step. This tab allows you to customize and configure the step's behavior and functionality. Once you have defined the current step to your desired specifications, you have two options to proceed:

* **Add Another Step**
  1. Click the "+" icon located on the workflow graph.
  2. A new step will be created and placed adjacent to the current step.
  3. You can then configure the newly added step in the "Details" tab.
* **Create Workflow**
  1. If you are satisfied with the workflow you have designed, click the yellow "Create Workflow" button located at the top-right corner of the screen.
  2. This action will finalize and create your workflow.
  3. The workflow will be saved and accessible for future use.

It's essential to carefully plan and configure each step of the workflow to ensure that the overall process works as intended. **Take your time reviewing and refining your workflow before finalizing it** as changes may be more challenging once the workflow is created.

If you want to go back and modify your workflow configuration, click the "Configure" button on the top-right corner. This will allow you to make changes to the steps, tasks, and settings of your workflow. Once you have made your changes, click the "Update Workflow" button to save them.

### View Workflows

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe2jl1uLrdM5iYS2hII641ijfTXAzZJriiIh0qKRjlkRBpTsS2rjVuYkakXGECCP_mYoPEdF7nOsq5eK84WWnKvAnnO998LeJ7b_NYtXjh4AevNFgQi0X_TRp66QpwUJvNg5xMn89Yhl308AUAVXNL8aqkG?key=CrjAmK76ZdHhNlRMtvcEMw" alt=""><figcaption></figcaption></figure>

Once you've created your workflow, you can monitor its status or run it from the Workflows page. The status of each step is indicated by a color:&#x20;

* Grey for not started
* Green for completed
* Yellow for an issue
* Red for a critical issue

### Configure your Fleet

#### Create a Fleet

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcQfmLXSsklOe5nxL2e72W6LwMaxrt9SeLLlinIWxo4n5XyVaEA3CV2b85G8ohlQJrcOeMtaPfvsu3mslL1v79ReuTlFbUcupa0dSy3GALUV5KrEtfew9-2fJMaP6CGB73NMEv9Wrr2gwOi0Cw5CN5xVcgC?key=CrjAmK76ZdHhNlRMtvcEMw" alt=""><figcaption></figcaption></figure>

The Fleets tab, located on the left column, allows you to manage your fleets. From here, you can create new fleets, configure existing ones, and view detailed information about each fleet. You can also add chips to your fleets to extend their capabilities and customize their behavior.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfRHwe3p5eDfsjeTtuI3ts3gug_yifDtnmlbhw1-H6p8XMJHYW6sHW0M7wPauTXxPZz2Yo-FO-SsIboIDBUHlShc06LN8TK07vJOUuDvbdTqWh3qEuJUzFfToz5YbJ9EiN8Wnls6EabAB8gcOtKlO-WUF93?key=CrjAmK76ZdHhNlRMtvcEMw" alt=""><figcaption></figcaption></figure>

To configure a fleet in Chassy, begin by assigning a descriptive name to the fleet and selecting the region where it will be located.

#### No chips present - add a new chip

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd5ySwdRCviLw-POZmU5BVPHAWgtmEvl8CKzZcSKP8B1A2sscB01dgpb7n1zPn0SMIBTJwWb3GC7vTYXHN25PBt2EIk7sgi0vNK8OT0TsZTk4KV9AKUSaZ1lMDbjhclIlQDU5Igy6v61oiWDzDkeBGFxCIL?key=CrjAmK76ZdHhNlRMtvcEMw" alt=""><figcaption></figcaption></figure>

If no chips are configured, you will be prompted to set up a new one. To do so:

1. Assign a descriptive name to the chip and select the region where it will be located.
2. Provide a human-readable description to explain its purpose.&#x20;
   * Platform refers to the software or firmware platform that is running on the chip. (An example could be a Nvidia Jetpack release or an Ubuntu LTS version)
   * Additionally, you can specify various properties as key-value pairs to assign attributes or group your chips as needed.&#x20;
   * These properties can be used to categorize and manage your chips effectively.

#### Select a chip

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdd3TIw7cMQu0sJ_q1HCewt2_hyAIu-K02pcex0v779H0lW6_pHZTOaVVID9QS9KP_GncPCYKLHFzB9PlJX1sqfrM4GM352OKSoGGhKrSu0ja4-1TGEFAM3pPOCpTYCOQXFRpLH9a92-abkojsWslvhyDPV?key=CrjAmK76ZdHhNlRMtvcEMw" alt=""><figcaption></figcaption></figure>

Select the chip to use and click continue.

### Enroll a Machine

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeU2ECbW26ZJWI9wCRUhtPA1jQZduN9deO-34_q05ETJ8eRpobYLh2wb58L3dg9EK6Pa3KcMbAiqUYWBIOlDdC3tnYK9KorFFDfZf_Ejgc2Q5VI7SD7CaBvrpSgqrUjqaGwvj-cxxNR5z2k05_KMsoNejs?key=CrjAmK76ZdHhNlRMtvcEMw" alt=""><figcaption></figcaption></figure>

To set up Chassy on a local machine, follow these steps:

1. Perform general housekeeping on the local machine, such as ensuring the operating system is up to date, verifying sufficient disk space and memory, disabling any firewall rules that may interfere with Chassy's communication, and ensuring a stable internet connection.
2. Generate an authentication token for Chassy to communicate with the machine by clicking on "Generate New Token" and following the instructions to generate a token. Chassy will store this token for you and send it to the machine in Step 4.
3. Select whether Chassy should manage a Docker image or an executable. More options are coming soon.
4. Copy and execute a curl command locally on the machine by opening a terminal window, copying the curl command provided by Chassy, pasting the command into the terminal window and executing it to install the Chassy agent on the machine.
5. Wait for the machine to connect to Chassy, which may take a few minutes, and monitor the terminal window for a confirmation message indicating that the machine is connected.

Congratulations! You've set up your first Chassy Workflow Pipeline. Next, you can learn more about the different [Workflow Components](/reference/workflow-components.md), how to [add more Users to your Chassy Workspace](/reference/create-and-delete-users.md), or adding [Integrations to Github Actions](/reference/integrations.md).


---

# 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/guides/get-started.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.