> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.id.me/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.id.me/_mcp/server.

# Ruby

> Learn more about integrating using Ruby

Version 1.0

Released July 11, 2017

\
\


View on Github

This is a sample seed Ruby Web App built with Sinatra

> **Note**
>
> You will need an [ID.me developer account](https://api.id.me/en/registration/new) to complete this process

## Prerequisites

You must have `ruby` and `rubygems` installed

## Installation

Download the [code](https://github.com/IDme/ruby-sample-code)

Install the required gems

```bash
gem install bundler
bundle install
```

Configure your oauth settings in `app.rb` with the values provided in your [developer account](https://api.id.me/en/session/new)

```ruby
# app.rb
client_id     = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"
scope         = "YOUR_SCOPE_VALUE"
```

Start the server

```bash
ruby app.rb
```

View the app at [http://localhost:4567](http://localhost:4567)