---
name: azion-how-to-install-orchestrator-agent
description: >-
  Learn how to download and install the Azion Orchestrator for various OS like Linux, FreeBSD, and MacOS, including command line instructions.
---

# How to install Orchestrator Agent

> **Note**
>
> Before installing the agent, it's necessary to generate a personal token.

[go to how to generate a personal token](/en/documentation/guides/platform/account-and-billing/personal-tokens/)

[go to Personal Token reference documentation](/en/documentation/fundamentals/personal-tokens/)

To begin the **Edge Node** installation process, you must download the **Orchestrator** installation binary of your choice.

Download the Azion Edge Node option that matches your operating system:

| Operating System | Architecture | File                                                                              |
| :--------------- | :----------: | --------------------------------------------------------------------------------- |
| FreeBSD          |    x86\_64   | [edge-orchestrator](https://downloads.azion.com/freebsd/x86_64/edge-orchestrator) |
| FreeBSD          |     ARM64    | [edge-orchestrator](https://downloads.azion.com/freebsd/arm64/edge-orchestrator)  |
| Linux            |    x86\_32   | [edge-orchestrator](https://downloads.azion.com/linux/x86_32/edge-orchestrator)   |
| Linux            |    x86\_64   | [edge-orchestrator](https://downloads.azion.com/linux/x86_64/edge-orchestrator)   |
| Linux            |     ARM32    | [edge-orchestrator](https://downloads.azion.com/linux/arm32/edge-orchestrator)    |
| Linux            |     ARM64    | [edge-orchestrator](https://downloads.azion.com/linux/arm64/edge-orchestrator)    |
| MacOS            |    x86\_64   | [edge-orchestrator](https://downloads.azion.com/darwin/x86_64/edge-orchestrator)  |

Alternatively, you can download it using the command line. In the example, the download link refers to the Linux/x86\_64 agent. If you want to download another version, just change the URL for the required operating system or architecture:

`curl -O http://downloads.azion.com/linux/x86_64/edge-orchestrator`

> **Note**
>
> The commands executed in the orchestrator agent must be executed with administrator privileges. It might be necessary to run the commands with `sudo`.

After downloading, follow the steps below to install the Orchestrator agent to your device:

1. Inside the directory where the binary is in, install the **Orchestrator** agent:

```bash
   sudo chmod +x edge-orchestrator
```

```bash
   sudo ./edge-orchestrator install
```

2. Enter your personal token when prompted.
3. Start the **Orchestrator** agent after installing it:

```bash
   sudo ./edge-orchestrator start
```

> **Note**
>
> If your operating system doesn't have a service manager (such as `systemd`), you must run it in the foreground.

```bash
   sudo ./edge-orchestrator start --foreground
```

> **Note**
>
> The logs to run the Orchestrator agent are stored in the installation directory, under `/var/log/azion/edge-orchestrator.log`