Navigation

Driver Compatibility

MongoDB Compatibility

The following compatibility table specifies the recommended version(s) of the MongoDB Ruby driver for use with a specific version of MongoDB.

The first column lists the driver versions.

Ruby Driver MongoDB 4.0 MongoDB 3.6 MongoDB 3.4 MongoDB 3.2 MongoDB 3.0 MongoDB 2.6 MongoDB 2.4
2.6  
2.5    
2.4    
2.3      
2.2      
2.0        
1.12        
1.11          
1.10          
1.9            
1.8            

The driver does not support older versions of MongoDB.

Language Compatibility

The following compatibility table specifies the recommended version(s) of the MongoDB Ruby driver for use with a specific version of Ruby.

The first column lists the driver versions.

Ruby Driver Ruby 2.5 Ruby 2.4 Ruby 2.3 Ruby 2.2 Ruby 2.1 Ruby 2.0 Ruby 1.9 Ruby 1.8.7 JRuby 9.2 JRuby 9.1 JRuby
2.6    
2.5        
2.4          
2.3          
2.2          
2.1          
2.0          
1.12 - 1.9            
1.8              
1.7 - 1.6                

Atlas Compatibility

Driver version 2.6.1 or higher is recommended when using MongoDB Atlas, as this version has significant SSL performance improvements.

When running on JRuby and connecting to Atlas Free Tier, driver version 2.6.3 or higher and Java 8 or higher are required.

JRuby Kerberos

If the mongo_kerberos gem is used for Kerberos authentication with JRuby, the the JVM system property “sun.security.jgss.native” to will be set to “true” in order to facilitate the use of the system cache of TGTs (e.g. TGTs obtained with kinit). Any other use of the JGSS library will also be affected by this setting, meaning any TGTs in the system cache will be available for obtaining Kerberos credentials as well.