Skip to content

docs(ruby): document mongo driver compatibility #3752

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
benjaminach merged 2 commits into from
May 18, 2026
Merged

docs(ruby): document mongo driver compatibility #3752

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
90c8323
docs(ruby): document mongo driver compatibility
benjaminach May 18, 2026
4fce188
Apply suggestions from code review
benjaminach May 18, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 31 additions & 3 deletions src/_posts/languages/ruby/2000-01-01-mongoid.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,15 @@
---
title: Configure Mongoid
nav: Mongoid
modified_at: 2023-12-22 00:00:00
modified_at: 2026-05-18 00:00:00
tags: ruby mongoid mongodb
---

{% warning %}
Use the Mongo Ruby driver `mongo` up to version `2.23.0` when connecting to
Comment thread
benjaminach marked this conversation as resolved.
Outdated
MongoDB Server `3.6` or `4.0`.
{% endwarning %}

You need to create the file `config/mongoid.yml` in order to configure Mongoid:

```yaml
Expand All @@ -20,6 +25,29 @@ production:
uri: <%= ENV['SCALINGO_MONGO_URL'] %>
```

Add the `mongo` gem to your `Gemfile`:

```ruby
gem 'mongo', '2.23.0'
```


## Connection Options

If you want to modify connection options or the connections pooling, you can
find all the information in the [official
documentation](https://www.mongodb.com/docs/mongoid/current/installation/).
find all the information in the [official documentation][mongoid-documentation].


## Mongo Ruby Driver Compatibility
Comment thread
benjaminach marked this conversation as resolved.
Outdated

Scalingo for MongoDB® supports MongoDB up to version `4.0.3`, the latest open
source version available.
Comment thread
benjaminach marked this conversation as resolved.
Outdated

The Mongo Ruby driver `mongo` version `2.24.0` removed support for MongoDB
Server `3.6` and `4.0`. As a consequence, **Ruby applications using MongoDB on
Scalingo must pin the `mongo` gem to version `2.23.0` or lower.**

For more information, see the [MongoDB Ruby Driver release notes][ruby-driver-release-notes].

[ruby-driver-release-notes]: https://www.mongodb.com/docs/ruby-driver/current/reference/release-notes/#std-label-ruby-version-2.23
[mongoid-documentation]: https://www.mongodb.com/docs/mongoid/current/