Skip to main content
Entire uses GitHub collaborator permissions to decide who can use a repository mirror. A mirror has two access requirements:
  • GitHub App access lets Entire see and mirror the source repository.
  • GitHub collaborator access controls who can clone, fetch, and push through the entire:// remote.
Entire updates mirror access when GitHub reports a collaborator change, and re-reads each repository’s collaborators at least once a day to catch changes it missed. There is no separate Entire-side permission list to grant or revoke manually.

Before Users Can Create or Join Mirrors

For organization repositories, a GitHub organization admin must install the Entire GitHub App and allow it to access the repository. See GitHub App Access for the GitHub App setup flow. Each user should also sign in with the Entire CLI:
This connects the user’s Entire account to their GitHub identity so Entire can check repository access.

Collaborator Sync

Entire updates mirror access from the GitHub collaborator list. GitHub notifies Entire of collaborator, team, and membership changes as they happen, and Entire also re-reads each repository’s collaborators at least once a day to catch any change it missed. A read-only GitHub collaborator can clone and fetch from the mirror. A GitHub collaborator with write access can also push through the mirror. GitHub access changes can take up to an hour to appear in Entire. If a GitHub collaborator has not signed in to Entire yet, automatic access can take up to an hour after they sign in.

User Self-Onboarding

After the GitHub App is installed, a user with access to the GitHub repository can create or join the mirror:
If the mirror does not exist yet, Entire creates it. If the mirror already exists, the command checks the current user’s GitHub access and returns the mirror URL.

Check Mirror Access

GitHub admins and repository owners can list the users who currently have mirror access:
This command is read-only. To change who can use the mirror, update collaborator access in GitHub and wait for Entire to pick up the change.

Offboard a User

When you offboard a user, remove their GitHub access. Entire updates mirror access when GitHub reports the change.
After GitHub access is removed, the user can no longer push mirrored branches through the mirror because those pushes are authenticated with GitHub. Pushes to entire/unmirrored/ branches never reach GitHub, so they, like clone and fetch access, may continue until Entire picks up the change. Entire usually learns of the change from GitHub right away. If that notification is missed, its background sync catches it within a day.

Continue With

Mirrors

Learn how mirrors make GitHub repositories available in Entire.

repo

See the command syntax for repository and mirror commands.

Troubleshooting

Fix mirror setup, access, clone, fetch, and push issues.