---
title: Ferrum (CDP)
---

# Ferrum (Chrome DevTools Protocol)

Google Chrome can be automated using
[Ferrum](https://github.com/rubycdp/ferrum).

When Ferrum is in use, a Google Chrome process is accessible within jobs like
so:

```ruby
Wayfarer.config.network.agent = :ferrum

class DummyWorker < Wayfarer::Worker
  route { to :index }

  def index
    browser # => #<Ferrum::Browser ...>
  end
end
```

## Configuring Ferrum

=== "Runtime"

    ```ruby
    Wayfarer.config.network.agent = :ferrum
    Wayfarer.config.ferrum.options = { headless: false, url: "http://chrome:3000" }
    ```

=== "Environment variables"

    ```
    WAYFARER_AGENT=ferrum
    WAYFARER_FERRUM_OPTIONS=headless:false,url:http://chrome:3000
    ```