Differences

This shows you the differences between two versions of the page.

--- newdevs:testserver [2023/04/14 10:41] – [Setting up a Development Environment] tmccanna
+++ newdevs:testserver [2026/04/12 03:25] (current) – Adding link to the container presentation bmagic
@@ Line 4: / Line 4: @@
 ==== Setting up a Development Environment ====
-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.
+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 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
+Full slide show conference presentation for setting up and some use cases: https://slides.mobiusconsortium.org/blake/evergreen_hack_class
 **Instructions:**
-  - Install git and clone the Evergreen git repository - see https://wiki.evergreen-ils.org/doku.php?id=newdevs:git:install
+  - Install GitHub - https://github.com/
+  - Install Git Bash and clone the Evergreen git repository - see https://wiki.evergreen-ils.org/doku.php?id=newdevs:git:install
+  - When installing Git Bash, make sure to choose the option "Checkout as-is, commit as-is".{{:newdevs:git_bash_checkout_as_is.png?400|}}
+  - If already installed incorrectly, use this command:<code>git config --global core.autocrlf false</code>and reclone Evergreen repo.
   - Install docker on your workstation. On Windows, that's "Docker Desktop" - https://www.docker.com/products/docker-desktop/
   - Make sure you're on a recent branch. Older branches (3.9 and below) may not work, as this container is running Ubuntu Jammy.
-  - Once Docker is installed and running, issue this command from Linux (update the folder paths to match your environment)
+  - Once Docker is installed and running, issue this command from Linux (update the folder paths to match your environment)<code>docker run -it -p 80:80 -p 443:443 -p 210:210 -p 6001:6001 -p 32:22
-<code>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</code>
+test.evergreen.com mobiusoffice/evergreen-ils:dev</code>Or, on Windows PowerShell:<code>docker run -it -p 80:80 -p 443:443 -p 210:210 -p 6001:6001 -p 32:22
-Or, on Windows PowerShell:
-<code>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</code>
-  - This may take up to 15 minutes to bring the server online depending on your hardware. When you see this, it is finished:
+  - This may take up to 15 minutes to bring the server online depending on your hardware. When you see this, it is finished:<code>PLAY RECAP
-<code>PLAY RECAP
+*****************************************************************************************************</code>There will be another minute or so delay for the Angular files to begin working.
-*****************************************************************************************************</code>
-There will be another minute or so delay for the Angular files to begin working.
   - Press CTRL+pq to keep it running. (CTRL+c will kill the container.)
   - Open a browser and go to 127.0.0.1 and click through any SSL warnings.