Link Search Menu Expand Document
Minicomp Wiki

Manual Installation Guide

Before starting with this guide, make sure this installation option makes the most sense for you by reading about the Pros and Cons.

Table of Contents

  1. On Mac
  2. On Windows
  3. On Linux

On Mac

  1. First you’ll want to install Homebrew. It’ll make installing everything else easier.

    Check on your terminal to see you if you have Homebrew installed by running the command:

     brew -v

    If you don’t have Homebrew, visit the Homebrew site and follow their installation instructions. In the process of installing Homebrew, you may get asked to install XCode Command Line Tools. Say yes.

  2. After you have Homebrew, install Git and Gnupg by running the command: 
     brew install git gnupg
  3. Install the image processing libraries using brew as well: 
      brew install imagemagick ghostscript libvips
  4. Lastly, install Ruby using RVM by running the following commands: 
      gpg --keyserver hkp://pool.sks-keyservers.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB

      \curl -sSL https://get.rvm.io | bash
  5. Quit and reopen the terminal. Then run the following command to get a modern Ruby that comes with Bundler: 
      rvm install 2.7.2

When you’re done, try following along with the Check for requirements tab to make sure everything is ready to go.

On Windows

  1. First install Ruby. The RubyInstaller for Windows 10 is probably the easiest way to get up and running. Make sure you install a Ruby version > 2.4 and less than 3.0! Recommended is “Ruby+Devkit 2.7.x” On the last installation step make sure to run the ridk install step on the last step of the installation wizard.

  2. Next install Git. The Git Download page includes good instructions and packages for all three major operating systems.

  3. Install ImageMagick by following the instructions on the ImageMagick Downloads page IMPORTANT!!! About half way down one of the install option menus is a checkbox with something like “Install legacy components (convert.exe etc)”. Tick this box!!!!

  4. Follow instructions on the GhostScript downloads page.

  5. Download and install libvips from GitHub.

When you’re done, try following along with the Check for requirements tab to make sure everything is ready to go.

On Linux

This depends on your flavor. If you have trouble, try pinging the Code4Lib #minicomp-wax channel.

When you’re done, try following along with the Check for requirements tab to make sure everything is ready to go.