42

Being really new to Ruby/Rails, and after attempting to resolve the issue myself this weekend I'm making an attempt to seek advice here.

I have a complete Ruby/Apache/Passenger setup done on FreeBSD, and I'm trying to accomplish the task of using Windows as a Ruby development environment.

So far:

  • Ruby is installed, v2.0.0p0 (2013-02-24) [x64-ming32]
  • Rails is installed, v.3.2.12
  • I have the Ruby dev kit installed and registered.
  • I have the sqlite3 dll/exe copied to the Ruby "bin" folder (which is also in my path using the "Start Command Prompt with Ruby" console.)
  • I can start a rails server successfully, and continuing with the http://guides.rubyonrails.org/getting_started.html tutorial to 3.3.
  • ">rake db:create" tells me:

    Please install the sqlite3 adapter: gem install activerecord-sqlite3-adapter ( sqlite3 is not part of the bundle. Add it to Gemfile.)

which I have no "understanding" of. Trying to install activerecord-sqlite3-adapter gives me a "Could not find a valid gem..."

  • ">gem install sqlite3" returns:

    Building native extensions. This could take a while... ERROR: Error installing sqlite3: ERROR: Failed to build gem native extension.

    D:/Development/Ruby200-x64/bin/ruby.exe extconf.rb checking for sqlite3.h... *** extconf.rb failed ***

Right now I'm stuck at the point where I don't even know what state my Ruby on Windows installation is in. I'm trying to follow the main Rails tutorial and it doesn't specify any of these issues (probably because Ruby on Windows seems to be a natural pain for a lot of people.)

What am I missing?!? I'm just trying to install sqlite3 for Ruby on Windows, seems simple right?

If I do ">rais db" the SQLite shell is presented:

SQLite version 3.7.15.2 2013-01-09 11:53:05

Similar questions with steps that do not resolve my issue: Installing SQLite 3.6 On Windows 7

10
  • The 'unanswered question' actually has an accepted answer. Have you tried putting the sqlite.dll in your ruby/bin directory?
    – PinnyM
    Mar 18, 2013 at 15:44
  • 2
    You are using an x64 ruby, the .dll is probably 32-bit and can't be used. You can try the x64 build of the .dll mentioned here.
    – PinnyM
    Mar 18, 2013 at 15:54
  • 1
    I don't know what the SO etiquette is for this, but I dropped a version of Ruby to 1.9.x, and ">gem install sqlite3" worked without issue.
    – chrisp
    Mar 18, 2013 at 16:29
  • 1
    I believe I followed your hint and specifically ensured I downloaded the 32bit version of Ruby. While I do understand that I can submit my own answer, the issue is, that it's not "the" answer. Version requirements are not discrete for me at this time, but downgrading seems like a "dirty" solution.
    – chrisp
    Mar 18, 2013 at 16:47
  • 1
    You don't need to downgrade - you can install 32-bit version of ruby 2.0 or use the 64-bit version of the .dll. RE: json gem, what error are you seeing?
    – PinnyM
    Mar 18, 2013 at 17:13

9 Answers 9

81

Even though the question has been answered, I want to post my research to help others. I found a lot of information online, but being a Ruby newbie I had a tough time following all. The basic answer comes from the following post https://github.com/luislavena/sqlite3-ruby/issues/82 with instructions by "paulwis" on how to properly install sqlite3 for ruby 2.0.0-p0 and some comments on https://github.com/rails/rails/issues/10150 . So here it is:

  1. Install the Ruby Devkit for your setup (DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe for me since I use a x64 machine)

  2. Download and extract the autoconf package from Sqlite.org

  3. Run msys.bat (it is inside the ruby devkit root folder)

  4. cd into the path where you downloaded the sqlite source (for example: "cd /c/dev/sqlite3" for path "c:\dev\sqlite3" if you are new to MSYS/MINGW32)

  5. Run "./configure"

  6. Run "make"

  7. Run "make install"

  8. Get the sqlite3 gem again, this time specifying the platform and the path to the newly compiled binaries:

    gem install sqlite3 --platform=ruby -- --with-sqlite3-include=[path\to\sqlite3.h] --with-sqlite3-lib=[path\to\sqlite3.o]
    

    For example:

    gem install sqlite3 --platform=ruby -- --with-sqlite3-include=/c:/dev/sqlite3/ --with-sqlite3-lib=/c:/dev/sqlite3/.libs/
    

    (from the paths given in step 4)

  9. Check the Gemfile.lock of your rails app and make sure that it points to the correct sqlite3 version. Mine was "sqlite3 (1.3.7-x86-mingw32)" and manually changed it to "sqlite3 (1.3.7-x64-mingw32)". Removing the platform also works: "sqlite3 (1.3.7)".

15
  • 1
    Thanks so much for this! Unfortunately step #8 failed for me: C:/Ruby200-x64/bin/ruby.exe extconf.rb --with-sqlite3-include=c:\sqlite-auto conf-3071602\sqlite3.h --with-sqlite3-lib=c:\sqlite-autoconf-3071602\.libs\sqlit e3.o checking for sqlite3.h... *** extconf.rb failed *** Could not create Makefile due to some reason, probably lack of necessary libraries and/or headers. Check the mkmf.log file for more details. You may need configuration options.
    – at.
    May 13, 2013 at 3:49
  • 2
    Finally got it to install, the issue was that I had to run the gem install command inside the MINGW32 terminal. Now I get this error when starting the Rails server: c:/Ruby200-x64/lib/ruby/gems/2.0.0/gems/sqlite3-1.3.7/lib/sqlite3.rb:6:in `require': cannot load such file -- sqlite3/sqlite3_native (LoadError)
    – at.
    May 13, 2013 at 10:50
  • 1
    In case someone else has the same problem, I had trouble with step 8 until I realized I was using \ instead of / in the MINGW32 window. Switching to forward slashes made it work.
    – Pam G
    Jun 14, 2013 at 21:20
  • 6
    For step 8, I ran the command out of the MINGW32 window and changed the command to be: gem install sqlite3 -- --with-sqlite3-include=/c/sqlite-autoconf-3071700/ --with-sqlite3-lib=/c/sqlite-autoconf-3071700/ (I extracted the source code to C:\sqlite-autoconf-3071700 on my machine)
    – Paul
    Jun 29, 2013 at 19:52
  • 1
    i can't see which is msys.bat, I only see msys.exe bro
    – TheBAST
    Feb 5, 2022 at 6:40
12

This is an old thread, but still relevant.

For us it was as simple as editing the Gemfile and adding a specific version for sqlite.

gem 'sqlite3', '~> 1.3.13'
1
  • 2
    Out of all the lengthy solutions. This is one worked for me. Thanks! May 18, 2019 at 11:45
11

I was able to install sqlite3 with ruby2.0.0 on win XP32 with following command:

c:\>gem install sqlite3 --platform=ruby -- --with-sqlite3-dir=C:/distr/sqlite --with-sqlite3-include=C:/distr/sqlite

Folder C:/distr/sqlite contains following files

  • shell.c
  • sqlite3.c
  • sqlite3.h
  • sqlite3ext.h
  • sqlite3.def
  • sqlite3.dll

So, basically I've extract sqlite-amalgamation-3071602.zip and sqlite-dll-win32-x86-3071602.zip to C:/distr/sqlite.

HEADS UP

You still need to put copy of sqlite3.dll and sqlite3.def somewhere to PATH. IMHO it's best to keep sqlite3 binaries in ruby's bin folder.

3
  • @Lucky, do you have DevKit installed from here rubyinstaller.org/downloads ?
    – denis-bu
    Oct 25, 2014 at 16:32
  • 1
    @denis-bu yes I 've already installed it..since this hasnt worked for me i used RailsFTW(a single package rails installer file which has prebundled ruby,rails,and sqlite for windows) and that worked for me..
    – Lucky
    Oct 26, 2014 at 11:59
  • 1
    I had to add --with-sqlite3-lib=C:/distr/sqlite also. Oct 25, 2016 at 17:22
2
#!/usr/bin/env sh

mkdir c:/sqlite3x86
wget -P c:/sqlite3x86 http://packages.openknapsack.org/sqlite/sqlite-3.7.15.2-x86-windows.tar.lzma
cd c:/sqlite3x86
bsdtar --lzma -xf c:/sqlite3x86/sqlite-3.7.15.2-x86-windows.tar.lzma
gem install sqlite3 --platform=ruby -- --with-opt-dir=c:/sqlite3x86
cd c:/
rm -rf c:/sqlite3x86
1

For windows, go to C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/sqlite3-1.3.13-x64-mingw32/lib/sqlite3.rb

and make sure

require "sqlite3" instead of native

3
  • 1
    Thanks. It helped after a simple gem install sqlite3 (Ruby 2.5.1, Rails 5.2). It now raises another error (file renaming permission failed). My question is: "is it safe? ie, is there a situation I will need to have sqlite3 native?" I feel like touching a library definition...
    – Al-un
    Sep 17, 2018 at 20:16
  • Strange though, I uninstalled the sqlite3 gem and reinstall it. Compilation options are no longer necessary for windows 10 ming-gw 64
    – zawhtut
    Sep 18, 2018 at 9:17
  • u mean something like this : ? ` # support multiple ruby version (fat binaries under windows) begin RUBY_VERSION =~ /(\d+\.\d+)/ require "sqlite3" # require "sqlite3/#{$1}/sqlite3_native" rescue LoadError require "sqlite3" # require 'sqlite3/sqlite3_native' end`
    – TheBAST
    Feb 4, 2022 at 9:14
1

Get the fat binary from here

https://ci.appveyor.com/project/MSP-Greg/sqlite3-ruby/build/3/job/hhk6ie8gdo545svr/artifacts

and

gem install c:\path\to\downloaded_gem.gem
1

You should follow this procedure:

  1. gem install bundler (add in Gem file_)
  2. gem 'sqlite3', ' < 1.4'(add in Gem file_)

then run:

install bundler
0

I figured I'd put in an answer -- from the comments, for posterity's sake. The issue seemed to be that I grabbed a new version of Ruby/Rails (for Windows) that was not compatible "yet" with SQLite3.

I downgraded to 1.9.x and was able to things running.

5
  • I'm using Ruby 2.0.0 and it is compatible with sqlite3
    – jonathanrz
    Jun 15, 2013 at 22:24
  • @jonathanrz thanks, I'm struggling to get 2.0.0 to compile sqilte3 and am glad to hear that yours is working. Would you mind weighing in on which instructions you followed to get it to compile? Jun 18, 2013 at 23:16
  • 1
    @TylerGannon I followed the paths from williams answer, but at step 8 I used denis-bu answer and added the libs dir with the .libs directory inside sqlite3 directory.
    – jonathanrz
    Jun 20, 2013 at 1:50
  • 1
    After much headache and frustration, @jonathanrz speaks the truth. Follow williams answer, then copy over path/to/sqlite3/.lib up a directory, then run denis-bu's call. Go team!
    – phyatt
    Jun 27, 2013 at 9:14
  • 2
    @jonathanrz and @phyatt, Thanks for the help. These instructions managed to get the thing to compile with no errors. Now when I try to actually use sqlite3 from ruby I get this error: 126: The specified module could not be found. - c:/Ruby200/lib/ruby/gems/2.0.0/gems/sqlite3-1.3.7/lib/sqlite3/sqlite3_native.so Jun 29, 2013 at 0:46
0

The easiest way to get set up for Ruby on Rails on a Windows machine is by using the RailsInstaller, which automatically installs and configures sqlite3 for you. One step.

http://railsinstaller.org/en

1
  • That's how I installed ruby and yet here I am
    – Carson
    Jan 13, 2020 at 3:18

Not the answer you're looking for? Browse other questions tagged or ask your own question.