Bibliomation Evergreen Internship Guide
Welcome. This guide orients Bibliomation interns to the Evergreen ILS, covering local workflows, environment setup, and community contribution practices.
Start Here
New to Evergreen? Follow the First Week Checklist to set up your environment, run Evergreen via Docker, and complete your first manual install.
What is Evergreen?
Evergreen is an open-source Integrated Library System (ILS) designed for libraries of all types and sizes. It provides a robust set of features for managing library operations, including cataloging, circulation, and patron management. Evergreen is built on a modular architecture, allowing for easy customization and integration with other systems.
Core Technologies
Evergreen is primarily developed using:
-
PostgreSQL: The database backend for storing all library data.
-
Perl: The primary programming language used for Evergreen backend development.
-
Angular: The primary framework used for Evergreen frontend development.
-
Antora: The documentation site generator used for Evergreen’s documentation. Also used to deploy this site.
Development Environment Requirements
See Prereqs & Tools for OS, Docker, Git, Node/NPM, pgAdmin, and account setup.
Good First Tasks
See First Week Checklist for your initial tasks and acceptance criteria.
Quick links
See Resources & Quick Links for curated references, servers, and bug search shortcuts.
-
Explore the community test servers:
-
Run the Evergreen dev Docker container and point it to the Evergreen code cloned from your fork.
-
Browse the Evergreen Documentation
-
Read existing bug reports on Launchpad to understand common issues and how they are resolved.
-
Build and install Evergreen manually. Follow the community install guide.