---
title: "Ruby on macOS"
slug: "prefix-ruby-on-mac"
description: "Learn how to set up Stackify Ruby Profiler on macOS in just 1 minute! Follow easy steps to download, install, and configure the profiler with Prefix. Verify requests in Prefix."
updated: 2021-01-29T22:30:18Z
published: 2021-01-29T22:30:18Z
---

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

# Ruby on macOS

Prerequisites:

          

- [Supported Ruby Technologies](https://docs.stackify.com/docs/supported)  

*Since Prefix and Retrace share the same modules/profiler, the supported frameworks between the two products will be the same in most cases.*

### 1. Download and install the Prefix installation file:

Check out the [Getting Started](https://docs.stackify.com/v1/docs/prefix-getting-started) Prefix page to download and install Prefix on your workstation.

### 2. Get the latest Stackify Ruby Profiler for Prefix:

Modify the application `Gemfile`:

```
gem 'stackify-ruby-apm'
```

### 3. Configure the Application to use the Profiler with Prefix Enabled:

- Add `config/stackify_apm.yml` to your application, modify **application_name** and **environment_name**.
- Add `prefix_enabled: true`to the **stackify_apm.yml** file.

```
application_name: 'Ruby Application'
environment_name: 'Production'
prefix_enabled: true
```

### 4. Initialize the Profiler:

#### Rails

Profiler will startup automatically, no additional configuration.

#### Non-Rails

Include **StackifyRubyAPM::Middleware** when starting your application:

```
# config.ru

require 'stackify-ruby-apm'
use StackifyRubyAPM::Middleware
StackifyRubyAPM.start

# application startup

at_exit { StackifyRubyAPM.stop }
```

#### Sinatra

```
# config.ru

require 'stackify-ruby-apm'
require 'sinatra/base'

class MyApp < Sinatra::Base
  use StackifyRubyAPM::Middleware

  # get '/' do ... 

end

StackifyRubyAPM.start 

run MyApp

at_exit { StackifyRubyAPM.stop }
```

**Build and Deploy your application.**

### 5. Verify application requests show up in Prefix