---
title: "Enrolling Linux Devices"
slug: "enrolling-linux-devices"
updated: 2024-12-06T07:53:16Z
published: 2024-12-06T07:53:16Z
canonical: "help.scalefusion.com/enrolling-linux-devices"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.scalefusion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enrolling Linux Devices

The first step to start managing your Linux devices is to enroll them to Scalefusion. Once enrolled you can apply the policies remotely and perform device level actions. Follow the steps below to enroll your devices.

### Prerequisites

1. Create an [Enrollment configuration](/docs/enrollment-configurations-for-linux-devices).
  1. Have the Enrollment URL handy.
2. sudo/root access on the machine that needs to be enrolled.
3. If you have installed a custom version of Linux/Debian, make sure the following packages are installed:
  1. curl
  2. lsb-release

## Steps

1. Open a terminal window on the device that you want to manage.
2. Since we would be using the **curl** command, the first step is to make sure that **curl** is installed. At the terminal window type the command below and hit enter. When prompted, enter your sudo/root password and to confirm the installation type **Y ![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image%20-%202023-09-07T125854.877.png)**

```shell
$ sudo apt install curl
```
3. Now paste the **Enrollment URL** at the terminal that you copied from the enrollment configuration created as a prerequisite and hit enter key. When prompted, please enter the sudo/root password  
![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image-1733470749895.png)

```ruby
curl -fsSL https://app.scalefusion.com/cloud/nix/enrollment/XXXXXXXXXXXXXXXXXXXXXXX==/script.sh | sudo bash
```
4. Step 3 would start downloading the Scalefusion agent and then install and complete the enrollment. Once the enrollment is complete you would see a message **Enrollment Succeeded ![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image-1733471536926.png)**

On the Scalefusion Dashboard, if you navigate to the **Devices** section, the newly enrolled device would be listed along with the columns that you have configured for your devices view.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image%20-%202023-09-07T131057.921.png)

1. **Device Status**: **Locked** indicates that the policies are actively, **Unlocked** indicates that the policies are relaxed. This field also displays the last connected time.
2. For Linux devices, Scalefusion displays the OS Code name along with the name of the device in the **Device Name** column.

## Frequently Asked Questions

1. **Question**: What if we don't see **Enrollment succeeded**at the end of enrollment and see some errors?
  1. **Answer**: If you see that there is an enrollment error then please extract all the logs files from the folder below and share it with [support@scalefusion.com](mailto:support@scalefusion.com) along with the screenshot of the error displayed on Terminal window.

```java
/var/log/tux-agent/reconfigure
```

### Next Steps

Now that the device is enrolled and the policies are applied, you can go through the [Device Inventory & Actions](/docs/linux-device-inventory-actions) document to understand the device details that Scalefusion provides and also the remote actions that can be performed.