joshjohanning/Bulk GitHub Organization Settings Sync

Bulk configure GitHub organization settings across multiple orgs

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Stale
License
None
namedescriptionrequireddefault
github-tokenGitHub token for API access (requires admin:org scope)yes
github-api-urlGitHub API URL (e.g., https://api.github.com for GitHub.com or https://ghes.domain.com/api/v3 for GHES). Instance URL is auto-derived.no${{ github.api_url }}
organizationsComma-separated list of organization namesno
organizations-filePath to YAML file containing organization settings configuration (orgs.yml)no
custom-properties-filePath to a YAML file defining custom property schemas to sync to target organizationsno
custom-property-values-filePath to a YAML file defining custom property values to sync to target organization repositoriesno
delete-unmanaged-propertiesDelete custom properties not defined in the configuration filenofalse
issue-types-filePath to a YAML file defining issue type definitions to sync to target organizationsno
delete-unmanaged-issue-typesDelete issue types not defined in the configuration filenofalse
issue-fields-filePath to a YAML file defining issue field definitions to sync to target organizationsno
delete-unmanaged-issue-fieldsDelete issue fields not defined in the configuration filenofalse
org-nameOrganization display nameno
org-descriptionOrganization description (max 160 chars)no
org-companyCompany nameno
org-locationLocationno
org-emailPublicly visible emailno
org-twitter-usernameTwitter/X usernameno
org-urlWebsite URLno
org-blogBlog/website URL (deprecated: use org-url)no
default-repository-permissionDefault permission level for org members on new repositories: read, write, admin, or noneno
members-can-create-repositoriesWhether non-admin organization members can create repositoriesno
members-can-create-public-repositoriesWhether members can create public repositoriesno
members-can-create-private-repositoriesWhether members can create private repositoriesno
members-can-create-internal-repositoriesWhether members can create internal repositories (GHEC/GHES only)no
members-can-fork-private-repositoriesWhether members can fork private repositoriesno
web-commit-signoff-requiredWhether contributors must sign off on commits made through the web interfaceno
members-can-create-pagesWhether members can create GitHub Pages sitesno
members-can-create-public-pagesWhether members can create public GitHub Pages sitesno
members-can-create-private-pagesWhether members can create private GitHub Pages sitesno
members-can-invite-outside-collaboratorsWhether members can invite outside collaboratorsno
members-can-create-teamsWhether members can create teamsno
members-can-delete-repositoriesWhether members can delete repositoriesno
members-can-change-repo-visibilityWhether members can change repository visibilityno
members-can-delete-issuesWhether members can delete issuesno
default-repository-branchDefault branch name for new repositories created in the organizationno
deploy-keys-enabled-for-repositoriesWhether deploy keys can be added to repositoriesno
readers-can-create-discussionsWhether users with read access can create discussionsno
members-can-view-dependency-insightsWhether members can view dependency insightsno
display-commenter-full-name-setting-enabledWhether to display commenter full name in issues and PRsno
organization-role-team-assignments-filePath to a YAML file defining organization role team assignments to syncno
custom-org-roles-filePath to a YAML file defining custom organization role definitions to sync (requires GitHub Enterprise Cloud)no
delete-unmanaged-org-rolesDelete custom organization roles not defined in the configuration filenofalse
custom-repo-roles-filePath to a YAML file defining custom repository role definitions to sync (requires GitHub Enterprise Cloud)no
delete-unmanaged-repo-rolesDelete custom repository roles not defined in the configuration filenofalse
dot-github-source-dirPath to a local directory whose contents should be synced to the .github repository in each target organization (creates a PR with changes)no
dot-github-private-source-dirPath to a local directory whose contents should be synced to the .github-private repository in each target organization (creates a PR with changes)no
create-missing-dot-github-reposWhether to create missing .github / .github-private repositories before syncing (only applies to repos with a configured source-dir). Requires administration: write on the GitHub App at the org level.nofalse
dot-github-repo-visibilityVisibility to use when creating the .github repository: public, private, or internal. EMU and restricted-GHEC orgs should set this to internal.nopublic
dot-github-private-repo-visibilityVisibility to use when creating the .github-private repository: public, private, or internal.noprivate
rulesets-fileComma-separated paths to JSON files, each containing a single organization ruleset configuration to syncno
delete-unmanaged-rulesetsDelete all other rulesets besides those being syncednofalse
code-security-configurations-filePath to a YAML file defining code security configurations to sync to target organizationsno
delete-unmanaged-code-security-configurationsDelete code security configurations not defined in the configuration filenofalse
actions-policy-allowed-actionsAllowed GitHub Actions policy: all, local_only, or selectedno
actions-policy-github-owned-allowedWhether GitHub-owned actions are allowed (only when allowed-actions is selected)no
actions-policy-verified-allowedWhether actions from GitHub Marketplace verified creators are allowed (only when allowed-actions is selected)no
actions-allow-list-filePath to a YAML file defining allowed actions/reusable workflow patterns (only when allowed-actions is selected)no
actions-policy-default-workflow-permissionsDefault GITHUB_TOKEN permissions for workflows: read or writeno
actions-policy-actions-can-approve-pull-request-reviewsWhether GitHub Actions can approve pull request reviewsno
dry-runPreview changes without applying them (logs what would be changed)nofalse
namedescription
updated-organizationsNumber of organizations successfully processed (changed + unchanged)
changed-organizationsNumber of organizations with reportable changes (or would have in dry-run mode)
unchanged-organizationsNumber of organizations with no reportable changes
failed-organizationsNumber of organizations that failed to update
warning-organizationsNumber of organizations that emitted warnings
resultsJSON array of update results for each organization