View on GitHub


Installing Equella

Environment setup

Assuming you are building and installing Equella in the same environment, the following should be setup. Details can be found in the Equella Dev Setup guide.

Needed if you are building your own install binary:

Build the Installer

If you don’t have / don’t want to use a pre-built binary, you can build EQUELLA from source yourself by following the instructions on the main EQUELLA repo.

Install Equella

  1. Unzip the equella install zip binary.
  2. Run the GUI installer:
     ~$ cd ~/equella-installer-{VERSION}
     ~$ java -jar enterprise-install.jar

    You’ll need to know where you’ve installed imagemagick, libav, java, and your database.

    • Imagemagick in Ubuntu, run ~$ whereis convert.
    • Libav in Ubuntu, run ~$ whereis avconv.

The ‘Institution Administration URL’ for local testing can be as simple as http://localhost:8080/admin/

Windows Install

Using the equellaserver and manager bat scripts, configure and install as Windows services.

Starting Equella

The primary log to watch is located under {install_location}/logs/resource-centre/{current_date}/application.{X.}html


~$ cd {install_location}/manager
~$ ./equellaserver start
~$ ./manager start

To stop Equella or the manager, run the same command to start the application, but pass in ‘stop’ instead of ‘start’.


Assuming Equella and the Equella Manager have been installed as services, navigate to your services, and select Equella to start.

Accessing Equella / Finish Setup

Use your browser to login to the EQUELLA manager (default is http://localhost:3000) From here you can click the “start” button to start the EQUELLA app server if not already done from a Windows service or *nix start script.

Once Equella has started you can log in to the server admin pages using the hostname and port you configured in the installer.

The installation process will need to be completed in the server admin pages. Please access the server admin pages, configure the fields presented, and once presented with the database screen, initialize the database.

At this point, Equella is ‘running’, but still needs an institution to be useful.

Import an Institution

  1. Download the 6.4 vanilla institution.
  2. Using the server admin pages, import the institution
  3. After the import completes, click ‘Return to Institution Management’
  4. Your newly imported institution should be enabled on the ‘Institutions’ page. Click ‘Login’ under ‘Actions’
  5. Login with the Equella super user TLE_ADMINISTRATOR, and use the institution password you set when configuring the institution import.