The following software is required to get Solidus running:
We recommend using [Homebrew][brew] to install these dependencies on your
Mac. Throughout this article, we will use the
brew command for installing
The Ruby documentation also recommends using
if you need to upgrade from your system's Ruby.
We also recommend configuring your development environment so that you can
install RubyGems without
Using Homebrew, you can install all of the requirements using the following commands:
brew install ruby sqlite3 imagemagick gem install rails
See more detailed installation information below.
If you run macOS Sierra or an older OS, you system's version of Ruby will need to be upgraded from 2.0.x to 2.2.2 or newer. You can check what version of Ruby you have installed with the following command:
The Ruby documentation recommends installing another, newer instance of Ruby using Homebrew:
brew install ruby
Homebrew prioritizes the Homebrew installation of Ruby
/usr/local/bin/ruby) above the system installation (
Rails and Solidus use SQLite 3 as the default relational database. SQLite is a widely-supported, lightweight way to send and receive data. Using Homebrew, you can install the latest version of SQLite 3 using the following command:
brew install sqlite3
Alternatively, you can download the pre-compiled binary from the SQLite website .
After installation, check the version number:
If all is well, this command will return a version number that looks something
3.16.0 2016-11-04 19:09:39 0f3eed3324eda2a2b8d3301e5a43dc58a3a5fd5f.
Rails includes everything you need to build and extend a web application. Once
you have Ruby and SQLite 3 installed on your system, you can install Rails via
gem command that comes as a part of Ruby:
gem install rails
This will install Rails as well as its dependencies.
ImageMagick helps you create, edit, and save to hundreds of image file formats. It is required by Paperclip , which Solidus currently uses to handle file attachments. To install ImageMagick via Homebrew, use the command:
brew install imagemagick
Alternatively, you can download a pre-compiled binary for macOS from the ImageMagick website .
Solidus is an open source platform supported by the community. We encourage everyone using Solidus to contribute back to the documentation and the code.