How To Install Ruby on Rails Mysql2 Gem on Windows 10

If you cannot install the MYSQL2 gem in Windows, you need to download the C-Header files from MYSQL. Unlike other gems, MYSQL2 requires direct linking into some of the native build files provided by the library. Unless you have MYSQL installed already, it means you need to download - and reference - this library from the Internet.

The problem is that since the MYSQL2 gem requires certain files to help it connect to the Internet, the gem uses these to at build. The error you'll receive will mention "Failed to build native extensions". This means your Windows system did not have the header files required for the gem to be installed correctly.


Encrypting your link and protect the link from viruses, malware, thief, etc! Made your link safe to visit.


The way to resolve this is to first log onto the MYSQL website and look for "C-Connector". This is basically the "driver" for MYSQL, allowing Windows to call a number of pre-compiled functions to help it communicate with local or external MYSQL installations. The purpose of this download is to ensure your computer has the necessary files to install the gem.

Once you have found the MYSQL C-Connector file, you need to download it to your hard drive. From this, unzip the file and place its contents on your hard drive. You must put it in a path which has no spaces, otherwise the installation reference will break. A path such as C:/downloads/mysql-c-connector/files will work fine. Please note you do NOT need to install this - only download the zipped archive, we can remove it after the gem has been installed.

If you have downloaded and placed the files on your hard drive, you need to then install the gem again. To do this, you should load up CMD and type the following command "gem install mysql2 --platform=ruby -- '--with-mysql-dir="C:mysql-connector-path"'".

This command will reference the newly installed MYSQL C-Connector library files which Ruby requires to build the gem. If you've downloaded / installed it correctly, this should allow Ruby to install the required files etc. If successful, the cmd will explain the gem has been installed; if not, it will likely be that you have either downloaded the incorrect files OR you have not got another necessary library installed on your system.

Since Windows comes with no external libraries, it's necessary to install any required from the Internet. This is one of the reasons most people don't like developing with Windows - ultimately, if you're able to download the correct header files, you should be fine.


Richard is a veteran Ruby on Rails developer with over 15 production applications. You can see his how to install MYSQL2 gem on Windows article on Medium if you need more information.

Alternatively, there are a number of videos on YouTube which also explain the process.
Article Source: http://EzineArticles.com/expert/Richard_Peck/2344303
Article Source: http://EzineArticles.com/9667710