---
title: "macOS"
description: "Install Tracer locally on your macOS under two minutes"
---

## 1. Install Tracer

Run the following command to install Tracer:

```bash
curl -sSL https://install.tracer.cloud | sh
```
<Accordion title="macOS Compatibility Notes">
While Tracer can run on macOS, certain features are limited due to system restrictions.<br/>
  **– eBPF features:** Disabled due to macOS kernel restrictions<br/>
  **– Process recognition:** Less precise than on Linux due to limited access to low-level system data

  For full functionality, including accurate process visibility and eBPF support, we recommend running Tracer directly on a Linux machine.
</Accordion>


## 2. Start Tracer agent

To start tracking a pipeline, run the following command:

```bash
sudo tracer login
```
<Info>This will open up a browser window to log in to your Tracer account.</Info>

To start tracking a pipeline, run the following command:

```bash
sudo tracer init
```

You will be prompted to configure the pipeline name. Filling this out ensures that each pipeline is uniquely identifiable, customizable, and easy to search later on.


<Tip>
**Tracer is now tracking your pipeline.**

Every run you launch for this pipeline will be automatically monitored.

**Note:** You will only need to run `tracer init` again for a new pipeline, not per pipeline run.
</Tip>


## 3. Launch pipeline

You can now choose to run any pipeline you want or use `tracer demo` to launch a prepared pipeline.

Run your own pipeline by following your usual workflow or **run this line in your terminal**:

```bash
sudo tracer demo
```

<Info>
`tracer demo` will run an nf-core fastquorum pipeline. This pipeline requires minimum 2GB RAM, 1 core vCPU, and 30GB storage to run efficiently.
</Info>

## 4. Monitor and Optimize Your Pipeline

<Card href="https://app.tracer.cloud/">
  <img
    className="block dark:hidden"
    src="/images/logo/tracer/Tracer Full Body - Black.png"
    alt="Tracer Logo"
    style={{ width: '10%', height: 'auto', marginBottom: '1rem' }}
  />
  <img
    className="hidden dark:block"
    src="/images/logo/tracer/Tracer Full Body - Black.png"
    alt="Tracer Logo"
    style={{ width: '10%', height: 'auto', marginBottom: '1rem' }}
  />

  <div style={{ fontSize: '1.3rem', fontWeight: '700', marginBottom: '1rem', color: 'inherit' }}>
    Watch your pipeline run in the Tracer dashboard
  </div>

  <div style={{ color: 'inherit' }}>
    View real-time metrics, resource usage, and performance insights for your pipeline runs.
  </div>
</Card>