> For the complete documentation index, see [llms.txt](https://docs.instruqt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.instruqt.com/getting-started/set-up-instruqt.md).

# Setting up

## Step 1: Create an account <a href="#create-account" id="create-account"></a>

1. Go to [play.instruqt.com/signup](https://play.instruqt.com/signup) and create an account.
2. Have your colleagues add you to your company's Instruqt team.

## Step 2: Explore the Web UI <a href="#explore-web-ui" id="explore-web-ui"></a>

For new users, we recommend getting started using our Web UI.

1. Go to [play.instruqt.com](https://play.instruqt.com)
2. Explore the content from your company's Instruqt team

## Step 3: Install the Instruqt CLI (optional) <a href="#install-cli" id="install-cli"></a>

For advanced, code-first workflows, you can install the Instruqt CLI. The CLI is available on macOS, Windows and Linux, and can be installed using the following methods.

### Using a package manager

{% tabs %}
{% tab title="macOS (homebrew)" %}

1. Open a terminal
2. Install the CLI using [Homebrew](https://brew.sh)

   <pre><code><strong>brew install instruqt/tap/instruqt
   </strong></code></pre>
3. Confirm the Instruqt CLI was installed correctly:

   <pre><code><strong>instruqt
   </strong></code></pre>

{% endtab %}

{% tab title="Windows (winget)" %}

1. Open a PowerShell window
2. Install the CLI using [WinGet](https://learn.microsoft.com/en-us/windows/package-manager/winget/):

   <pre><code><strong>winget install instruqt
   </strong></code></pre>
3. Close and re-open the PowerShell window
4. Confirm the Instruqt CLI was installed correctly:

   <pre><code><strong>instruqt
   </strong></code></pre>

{% endtab %}
{% endtabs %}

### Manually from the latest release

Instruqt CLI releases are published to GitHub. You can download the latest release for your Operating System from <https://github.com/instruqt/cli/releases/latest>. Refer to the instructions below how to install these for your system.

{% tabs %}
{% tab title="macOS" %}

1. Open a terminal.
2. Download the appropriate CLI **(Apple Silicon or Intel Macbook, in that order):**

   ```bash
   curl -L https://github.com/instruqt/cli/releases/latest/download/instruqt-darwin-arm64.zip -o instruqt.zip
   ```

   ```bash
   curl -L https://github.com/instruqt/cli/releases/latest/download/instruqt-darwin-amd64.zip -o instruqt.zip
   ```
3. Extract the CLI binary:

   ```bash
   unzip instruqt.zip
   ```
4. Copy the binary to your local `bin` directory:

   ```bash
   sudo cp instruqt /usr/local/bin
   ```
5. Make the binary executable:

   ```bash
   sudo chmod +x /usr/local/bin/instruqt
   ```
6. Confirm the Instruqt CLI was installed correctly:

   ```
   instruqt
   ```

{% hint style="info" %}
**Need help?**\
Here's a [video tutorial](https://www.youtube.com/watch?v=6N1c5kMU4P4) to guide you through the installation process.
{% endhint %}
{% endtab %}

{% tab title="Windows" %}

1. Open a PowerShell window.
2. Copy and paste the following code:

   ```powershell
   mkdir scripts
   cd scripts
   [Environment]::SetEnvironmentVariable("Path", $env:Path + ";$($pwd.Path)", "User")
   Invoke-WebRequest -Uri https://github.com/instruqt/cli/releases/latest/download/instruqt-windows.zip -OutFile "instruqt.zip"
   Expand-Archive instruqt.zip -d .
   rm instruqt.zip
   ```
3. Close and re-open your Powershell window to detect the new program.
4. Enter the following command to check if Instruqt CLI was installed correctly:

   ```
   instruqt
   ```

{% hint style="info" %}
**Need help?**\
Here's a [video tutorial](https://www.youtube.com/watch?v=i4WH5WU_20w) to guide you through the installation process.
{% endhint %}
{% endtab %}

{% tab title="Linux" %}

1. Open a terminal.
2. Download the CLI:

   ```bash
   curl -L https://github.com/instruqt/cli/releases/latest/download/instruqt-linux.zip -o instruqt.zip
   ```
3. Extract the CLI binary:

   ```bash
   unzip instruqt.zip
   ```
4. Copy the binary to your local `bin` directory:

   ```bash
   sudo cp instruqt /usr/local/bin
   ```
5. Make the binary executable:

   ```bash
   sudo chmod +x /usr/local/bin/instruqt
   ```
6. Confirm the Instruqt CLI was installed correctly:

   ```bash
   instruqt
   ```

{% hint style="info" %}
**Need help?**\
Here's a [video tutorial](https://www.youtube.com/watch?v=i4WH5WU_20w) to guide you through the installation process.
{% endhint %}
{% endtab %}
{% endtabs %}

{% hint style="info" %}
The Instruqt CLI collects basic usage information and sends crash reports by default. No personal information is collected. You can disable these behaviours [by following this guide](/reference/cli/commands.md#telemetry-and-crash-reports).
{% endhint %}