{"id":19098513,"url":"https://github.com/ucfopen/obojobo-deploy","last_synced_at":"2025-07-03T21:38:15.008Z","repository":{"id":46064018,"uuid":"197087512","full_name":"ucfopen/Obojobo-Deploy","owner":"ucfopen","description":"A reference setup on how to deploy and customize an Obojobo Next Server","archived":false,"fork":false,"pushed_at":"2022-12-04T03:15:13.000Z","size":1406,"stargazers_count":0,"open_issues_count":15,"forks_count":0,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-02-22T09:30:01.759Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ucfopen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-07-15T23:53:28.000Z","updated_at":"2019-12-23T06:26:23.000Z","dependencies_parsed_at":"2023-01-23T23:18:51.195Z","dependency_job_id":null,"html_url":"https://github.com/ucfopen/Obojobo-Deploy","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ucfopen/Obojobo-Deploy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ucfopen%2FObojobo-Deploy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ucfopen%2FObojobo-Deploy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ucfopen%2FObojobo-Deploy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ucfopen%2FObojobo-Deploy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ucfopen","download_url":"https://codeload.github.com/ucfopen/Obojobo-Deploy/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ucfopen%2FObojobo-Deploy/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261892939,"owners_count":23226015,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T03:46:08.638Z","updated_at":"2025-06-25T14:38:06.641Z","avatar_url":"https://github.com/ucfopen.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Obojobo-Deploy\n\nA reference setup for how to deploy and customize an Obojobo Next Server.\n\n## Extending Express\n\nObojobo runs on [Express.js](https://expressjs.com).  Using Express's [middleware](http://expressjs.com/en/guide/writing-middleware.html#writing-middleware-for-use-in-express-apps), you can extend Obojobo infinately by adding your own routes, api endpoints, and pages.\n\n## Configuration\n\nObojobo follows The Twelve Factor App methodology pertaining to [environment variables for configuration](https://12factor.net/config). To take advantage of it, we'll include an example of loading configuration variables from AWS's Secrets Manager.\n\n### ENV vars required to load secrets\n\n* `AWS_SECRETS_REGION`\n* `AWS_SECRETS_KEY`\n\n### ENV vars required for application\n\nThes can be defined any number of ways, via `.env`, `/etc/environment`, export, or secrets manager.\n\n* `NODE_ENV`\n* `DEBUG`\n* `DB_USER`\n* `DB_PASS`\n* `DB_HOST`\n* `DB_NAME`\n* `DB_PORT`\n* `DB_SSL`\n* `OBO_COOKIE_SECRET`\n* `OBO_COOKIE_SECURE`\n* `OBO_LTI_KEYS_JSON`\n\n\n## Running a Production Server\n\n[PM2](http://pm2.keymetrics.io/) is a process manager for Node.  We'll use it here to run a production server and keep it fresh and fast.\n\n\n```bash\n\n# install npm modules\nyarn install --production=true\n\n# start the pm2 server\nyarn start\n\n# make sure pm2 starts on startup\nyarn pm2 unstartup\nyarn pm2 startup\n\n# save the current pm2 processes\nyarn pm2 save\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fucfopen%2Fobojobo-deploy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fucfopen%2Fobojobo-deploy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fucfopen%2Fobojobo-deploy/lists"}