Thank you to Blake Henderson and MOBIUS for the development of this Docker container that is specifically set up to edit Evergreen and have on-the-fly results on the Evergreen server. This container has been tested on Windows and Linux and theoretically will work on OSX.

README Page for the Container: https://hub.docker.com/r/mobiusoffice/evergreen-ils

Git Repo that builds the Container: https://github.com/mcoia/eg-docker

Instructions:

1. Install GitHub - https://github.com/
2. Install Git Bash and clone the Evergreen git repository - see https://wiki.evergreen-ils.org/doku.php?id=newdevs:git:install
3. When installing Git Bash, make sure to choose the option "Checkout as-is, commit as-is". If already installed incorrectly, use this command:

   git config --global core.autocrlf false

   and reclone Evergreen repo.

4. Install docker on your workstation. On Windows, that's "Docker Desktop" - https://www.docker.com/products/docker-desktop/
5. Make sure you're on a recent branch. Older branches (3.9 and below) may not work, as this container is running Ubuntu Jammy.
6. Once Docker is installed and running, issue this command from Linux (update the folder paths to match your environment)

   docker run -it -p 80:80 -p 443:443 -p 210:210 -p 6001:6001 -p 32:22 
   -p 5433:5432 -v /home/user/Evergreen:/home/opensrf/repos/Evergreen -h 
   test.evergreen.com mobiusoffice/evergreen-ils:dev

   Or, on Windows PowerShell:

   docker run -it -p 80:80 -p 443:443 -p 210:210 -p 6001:6001 -p 32:22 
   -p 5433:5432 -v //c/users/blake/Documents/GitHub/Evergreen:/home/opensrf/repos/Evergreen 
   -h test.evergreen.com mobiusoffice/evergreen-ils:dev

7. This may take up to 15 minutes to bring the server online depending on your hardware. When you see this, it is finished:

   PLAY RECAP
   *****************************************************************************************************

   There will be another minute or so delay for the Angular files to begin working.

8. Press CTRL+pq to keep it running. (CTRL+c will kill the container.)
9. Open a browser and go to 127.0.0.1 and click through any SSL warnings.
   • The staff home page will be https://localhost/eg/staff (login with admin / demo123)
   • Edits to the template toolkit files Open-ILS/src/templates(-bootstrap) are live.
   • Edits to the AngularJS folder Open-ILS/web/js/ui/default/staff are live.
   • Edits to the Angular folder Open-ILS/web/eg2 are NOT LIVE because the folder needs to be compiled when files are edited. The container is waiting for you to let it know when it should do that. In order to let it know, you need to create a regular file in the root of your Evergreen folder called "eg_rebuild_angular". The build output will be provided back to you by way of a file called "eg_rebuild_angular_screenoutput".
   • Perl edits are not live (because Perl). Changes to the Perl will require Evergreen services to restart. Similar to the Angular compile trigger, you can trigger the container to restart the Evergreen services by placing a regular file in the root of your Evergreen folder called "eg_restart_go". The container will react on the next minute. It's a cron job that runs on the minute every minute.

Evergreen Conference Session by Michele Morgan of NOBLE

• Grow Your Own Evergreen! Exploring, Hacking, and Testing On Your Very Own Test System