Ruby Product Analytics installation

Install with the wizard

Run this command in your project directory to add PostHog to your Ruby project. The wizard detects your framework, installs the SDK, and sets up your first events.

Learn more

Or set it up manually by following the rest of this guide.

Install the gem

Required

Add the PostHog Ruby gem to your Gemfile:

Gemfile

gem "posthog-ruby"

Configure PostHog

Required

Initialize the PostHog client with your project token and host:

Ruby
require 'posthog'

posthog = PostHog::Client.new({
    api_key: "<ph_project_token>",
    host: "https://us.i.posthog.com",
    on_error: Proc.new { |status, msg| print msg }
})

Send events

Recommended

Once installed, you can manually send events to test your integration:

Ruby
posthog.capture({
    distinct_id: 'user_123',
    event: 'button_clicked',
    properties: {
        button_name: 'signup'
    }
})

Next steps