Markdown Tutorial for Installing Evergreen on Debian Latest

This tutorial will guide you through the process of installing Evergreen on Debian Latest.

Prerequisites

Before starting, make sure that you have the following:

• A Debian Latest installation
• Administrative privileges
• Internet connection

Step 1: Update Your System

First, update your system using the command below:

sudo apt update && sudo apt upgrade

This command will update your system and ensure that you have the latest security patches.

Step 2: Install PostgreSQL

Evergreen requires a PostgreSQL database to function. Install PostgreSQL using the following command:

sudo apt install postgresql postgresql-contrib

Step 3: Install Required Packages

Install the required packages for Evergreen using the following command:

sudo apt install software-properties-common openjdk-11-jdk-headless libxml2-utils apache2-utils libfontconfig1 apache2 libapache2-mod-perl2 libapache2-mod-wsgi-py3 git

Step 4: Install Evergreen

Clone the Evergreen repository from GitHub using the following command:

git clone https://github.com/EvergreenILS/Evergreen.git

Change into the Evergreen directory using the following command:

cd Evergreen

Run the following command to install Evergreen:

sudo ./Open-ILS/src/extras/install_evergreen.sh -de

This command will install Evergreen with the development environment option.

Step 5: Configure Apache

Configure Apache by creating a new configuration file using the following command:

sudo nano /etc/apache2/sites-available/evergreen.conf

Copy and paste the following code into the configuration file:

<VirtualHost *:80>
    ServerName yourdomain.com
    DocumentRoot /usr/local/share/evergreen/opac/
    <Directory /usr/local/share/evergreen/opac/>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
    WSGIProcessGroup evergreen
    WSGIDaemonProcess evergreen processes=2 threads=15 display-name=%{GROUP} python-home=/usr/local/share/even
    WSGIScriptAlias / /usr/local/share/even/Open-ILS/src/perlmods/egwebapp.wsgi
    ErrorLog ${APACHE_LOG_DIR}/evergreen_error.log
    CustomLog ${APACHE_LOG_DIR}/evergreen_access.log combined
</VirtualHost>

Save and exit the file.

Enable and restart Apache using the following commands:

sudo a2ensite evergreen.conf
sudo service apache2 restart

Step 6: Set Up Evergreen

Set up the Evergreen database using the following command:

sudo -u evergreen /usr/bin/pgloader -v /usr/local/share/even/Open-ILS/examples/pgloader/pgloader.defaults /usr/local/share/even/Open-ILS/examples/pgloader/pgloader.load

Step 7: Log in to Evergreen

Open a web browser and navigate to http://yourdomain.com. Log in to Evergreen using the following credentials:

• Username: admin
• Password: password

Congratulations, you have successfully installed Evergreen on Debian Latest!

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!