How to Install Evergreen on macOS

Evergreen is an open-source integrated library system that provides flexible and scalable solutions for library management. This tutorial will guide you through the installation process of Evergreen on macOS.

Prerequisites

Before you start, you need to ensure the following is installed on your system:

Step 1: Install PostgreSQL

To install PostgreSQL, open the Terminal app on your macOS and run the following command:

brew install postgresql

Once the installation is complete, start the PostgreSQL server with the following command:

pg_ctl -D /usr/local/var/postgres start

You can also add PostgreSQL to startup items so that it starts automatically after a reboot.

Step 2: Install Evergreen Dependencies

Next, you need to install the dependencies required by Evergreen. To do this, open the Terminal app and run the following command:

brew install git automake autoconf libtool pcre perl gettext libxml2 libxslt openldap readline

Step 3: Clone Evergreen Repository

To clone the Evergreen repository, you need to run the following command:

git clone https://github.com/evergreenils/evergreen.git

Once the repository has been cloned, switch to the cloned directory using the following command:

cd evergreen

Step 4: Configure and Install Evergreen

To configure and install Evergreen, run the following commands:

./autogen.sh
./configure --prefix=/usr/local/evergreen
make
sudo make install

The above commands will configure and install Evergreen on your macOS system.

Step 5: Configure Evergreen Database

To configure the Evergreen database, you need to run the following command:

createdb evergreen

Once the database has been created, you can configure Evergreen to use PostgreSQL as its database by modifying the database configuration file. This file is located at /usr/local/evergreen/conf/OpenILS/global.tt2.

In this file, find the following line:

__DBI_dsn = "dbi:mysql:database=evergreen;host=localhost;port=3306"

Replace it with the following:

__DBI_dsn = "dbi:Pg:dbname=evergreen;host=localhost"

Step 6: Start Evergreen

Finally, you can start Evergreen by running the following command:

/usr/local/evergreen/bin/OpenSRF-extras start

Once Evergreen has started, you can access it by opening your web browser and entering the following URL:

http://localhost:8080/

Congratulations, you have successfully installed Evergreen on your macOS system!

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!