{"id":22325515,"url":"https://github.com/jamf/depnotify-starter","last_synced_at":"2025-04-05T10:09:52.391Z","repository":{"id":41128710,"uuid":"140896468","full_name":"jamf/DEPNotify-Starter","owner":"jamf","description":"Bash script to start DEPNotify and run policies during enrollment with Jamf Pro","archived":false,"fork":false,"pushed_at":"2023-09-11T03:47:17.000Z","size":32837,"stargazers_count":375,"open_issues_count":22,"forks_count":85,"subscribers_count":53,"default_branch":"master","last_synced_at":"2025-03-29T09:11:50.691Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://gitlab.com/Mactroll/DEPNotify","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jamf.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-07-13T22:00:50.000Z","updated_at":"2025-02-20T15:32:15.000Z","dependencies_parsed_at":"2024-12-04T02:12:26.518Z","dependency_job_id":"d15a4b96-1b13-456b-8aee-bc9eba754a7c","html_url":"https://github.com/jamf/DEPNotify-Starter","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamf%2FDEPNotify-Starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamf%2FDEPNotify-Starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamf%2FDEPNotify-Starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamf%2FDEPNotify-Starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jamf","download_url":"https://codeload.github.com/jamf/DEPNotify-Starter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247318745,"owners_count":20919484,"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-12-04T02:12:22.812Z","updated_at":"2025-04-05T10:09:52.371Z","avatar_url":"https://github.com/jamf.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DEPNotify Starter for Jamf Pro\nTemplate bash script to start DEPNotify and run Policies during enrollment with Jamf. App installer, source code, and full product documentation can be found at: https://gitlab.com/Mactroll/DEPNotify\n\nScript configuration can also be achived using the following app: [DEPNotify Set-up Helper](https://github.com/BIG-RAT/DEPNotify-Set-up-Helper/releases/latest/download/DEPNotify.Set-up.Helper.zip)\n\n![](example-img/fullscreen_setup.png)\n\n## General Information\n\n**Please review [RELEASES.md](RELEASES.md) to ensure proper version pairing of the script and DEPNotify app.**\n\nThis script is designed to make implementation of DEPNotify very easy with limited scripting knowledge. The script has variables that may be modified to customize the end user experience. DO NOT modify things in or below the CORE LOGIC areas unless major testing and validation is performed.\n\n**This script is set to `TESTING_MODE` by default.**\n\nThere is a [warning alert box](example-img/fullscreen_testing_mode.png) that will show if `TESTING_MODE` is set to `true` in version 1.2.0 and later. Having testing mode on will cause the following things to occur:\n\n* Sleep commands in place of running policies or other things that may effect the device configuration\n* Removal of BOM and configuration files\n* Command + Control + x is set to quit or interrupt DEPNotify\n\nThe script will need to be changed from `TESTING_MODE=true` to `TESTING_MODE=false` for production deployment.\n\n**It is recommended that you read the script fully and make changes that suit your organization prior to deployment to end user devices. Also, don't forget to test, test, and test again!**\n\n## Configuration within Jamf Pro\n\nWhile each organization will use a setup tool like DEPNotify differently, this script is designed with an end user provisioning model in mind. Changing the workflow should result in testing prior to production release.\n\n1. [Create policies](example-img/jamfpro_policy_configuration.png) in Jamf Pro to install core software during first setup. Set the frequency to ongoing and the trigger to custom and type in a manual trigger. Screenshot below showing how a single policy is configured\n2. Once software policies are created, customize this script with changes to verbiage as well as updating the POLICY_ARRAY with appropriate information. Double check the testing flag once you are ready to proceed\n  * (Optional) If using the [EULA window](example-img/fullscreen_eula_user_input.png), there must be a .txt file saved somewhere locally prior to DEPNotify running. A by default, the script is looking in /Users/Shared for eula.txt\n  * (Optional) If using the [registration window](example-img/fullscreen_register_user_input.png), you must have the departments and buildings in Jamf prior to running DEPNotify on the client. Each text box or drop down has its own code so that it can be modified to suit individual needs. Make sure to test a bunch if the logic sections are changed\n3. Upload DEPNotify.pkg (downloaded from https://gitlab.com/Mactroll/DEPNotify/tags) and this script to Jamf Pro. Create a policy to install the PKG and this script using the Enrollment Complete trigger. Also set the execution frequency to ongoing\n  * (Optional) If using the EULA, add the EULA.pkg built in step 2 to this policy as well\n  * (Optional) [Policy parameters](example-img/jamfpro_policy_parameter_values.png) can be used to configure true/false flags to make testing features easier\n4. Once a computer is finished enrolling, the DEPNotify policy will start and then call the other policies in order based on the array.\n\n#### FileVault Support\n\nIf you are requiring FileVault encryption, the script will automatically check at the end of running policies if deferred enablement is on. This will trigger a logout instead of a quit of DEPNotify.\n\n#### Additional Information\n\nFor this script, verbose comments have been added to assist in configuration and understanding. For more information on DEPNotify, visit https://gitlab.com/Mactroll/DEPNotify\n\n## Software Versions and Releases\n\nSoftware versions started to get rather cumbersome as versions of the script deviated from the app's version. Documentation of the script to app testing as well as macOS versions can now be found on the [RELEASES.md](RELEASES.md) file.\n\n## Change Log\n\nThe change log was getting a bit long and now has moved to its own page. Please visit the [CHANGELOG.md](CHANGELOG.md) for more information.\n\n## Contributors\n\nThis project could not have happened without several people's assistance. A special thanks to those individuals can be found on [CONTRIBUTORS.md](CONTRIBUTORS.md)\n\n## Migration\n\nThis project was moved from https://github.com/jamfprofessionalservices/DEPNotify\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamf%2Fdepnotify-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjamf%2Fdepnotify-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamf%2Fdepnotify-starter/lists"}