How to manage users and restrict builds

HockeyApp offers 5 different user roles:

  1. An Owner can create, manage, and delete apps in the personal or organization account, and add other owners. For organization accounts, you can add additional owners and give them access to all apps or just the ones that they created or were invited too. You can also set an option to let them handle the billing. There is a separate document about managing owners here.

  2. A Manager can create, manage, and delete teams.

  3. A Developer can upload and release new builds to an existing app, can view crash logs, feedback, and all data, and invite or remove other developer, members, or testers. A developer can not create a new app or delete an existing app.

  4. A Member can view all data, install builds, and reply to feedback. He can not modify or delete any data.

  5. A Tester can install builds and give feedback.

Inviting Users

You can invite a user to HockeyApp by adding them to a distribution group or directly to an app.

Distribution Groups

Distribution Groups help you to simplify your workflows. For example, when adding the same testers to multiple apps. Any number of teams can be created, and both testers and apps may belong to multiple teams.

To invite a tester to a team, open the Distribution Group tab, click on the distribution group, then on Invite Users, and enter the tester's email address. You can add multiple testers by pressing the enter key or clicking on the + button. You can set the role for each user by clicking on the underline role, Managers are allowed to add and remove testers from this Distribution Group. Finally, confirm with the Save button. An invitation email is sent to each new tester.

Apps

When a user should have only access to a single app or build, you can invite them directly to the app. To do this, click on the app, then on Invite User, and enter the user's email address. You can set the role for the user and add one or more tags to them. Finally, confirm with the Save button. An invitation email is sent to the user.

Adding Apps

To add more apps to a team, open the Teams tab, click on the team, then on Apps. Select the app and click on Add to Team. On the next page, you can enter an optional notification email; otherwise the apps are added silently to the user's dashboard. Finally, confirm with the Submit button.

To add more apps to a single user, open the Teams tab, click on the Contacts button (with the book icon), then search for the user and open the user page. Click on Add Apps, select the role, tags, and enter an optional message. The user will get one invitation email to accept the new apps.

Removing Users

To remove an app from a distribution group, open the Distribution Groups tab, click on the distribution group, then on Apps. Click on the gear icon in the app's row and select Remove. HockeyApp will remove each member from the app unless they are members of a different distribution group that is still part of this app.

To remove an app from a tester, open the distribution groups tab, click on the Contacts button (with the book icon), then search for the user and open the user page. Click on the Remove User button to remove the user from all apps. Or click on each app, then on Manage User, and use the Remove button to remove the user from this app.

Note that you can not remove the owner of an app or yourself. To leave a distribution group or app, click on your name in the top-right corner, then on Invites. Search the team or app, and click on Leave.

Restricting Builds

After you have uploaded an iOS or Android app, HockeyApp will show the release agent with four steps:

  1. Fill out the field Release Notes
  2. Set the fields Downloadable and Restrict Downloads, then select one or more teams, users, or tags
  3. Select the users that you want to notify via email
  4. Finish with Done

If the version is already released, you can modify or remove the restriction by clicking on the version, then on Manage Version > Status. You can also set the tags through our Developer API or HockeyApp for Mac.

Note that the restriction requires the user to register his device, otherwise he or she will not be able to download the restricted build.