Hilary is the back-end for the Open Academic Environment. The current frontend is at 3akai-ux but we're slowly building a new one, check it out: Cake
There's a docker image on docker-hub that works out of the box: https://hub.docker.com/r/oaeproject/oae-demo
If you want to build that image locally, you can do that by following instructions at https://github.com/oaeproject/oae-demo/
Here are the quick instructions on how to get OAE set up locally. There's also a more in-depth step-by-step tutorial in the wiki.
node -v # make sure you have v16+
npm -v # make sure you have 7.0.8+
git clone https://github.com/oaeproject/Hilary.git && cd Hilary
git submodule update --init
docker-compose up -d oae-cassandra oae-elasticsearch oae-redis oae-nginx
cd ethercalc && npm install && cd ..
cp ep-settings.json etherpad/settings.json
# on settings.json, please change `oae-redis` and `oae-cassandra` to `localhost`, for now
cp ep-package.json etherpad/src/package.json
cp ep-root-package.json etherpad/package.json
./prepare-etherpad.sh
cd 3akai-ux && npm install && cd ..
npm i
npm run migrate ; npx pm2 startOrReload process.json ; npx pm2 logs
In order to set up OAE on Codespaces, you need to follow the same steps as above. However, every time you re-create a codespace, you'll just need to re-run the services as follows:
docker-compose up -d oae-cassandra oae-elasticsearch oae-redis oae-nginx
npm run migrate
npx pm2 startOrReload process.json --only "Ethercalc, Etherpad"
# if you want to run tests
npm run test
# if you want to run the backend
npm run serve
To run tests just make sure you have installed all dependencies (check wiki page on how to set up a dev environment) and run npm run test. To run tests on a specific module, just append its path as follows: npm run test-module --module=oae-principals.
The project website can be found at http://www.oaeproject.org. The project blog will be updated with the latest project news from time to time.
The mailing list used for Apereo OAE is [email protected]. You can subscribe to the mailing list at https://groups.google.com/a/apereo.org/d/forum/oae.
Bugs and other issues can be reported in our issue tracker and we're always available to help in our discord channel.