Goal: give each person on your team their own login with the access their job needs, and nothing more.
Time: about 20 minutes.
Before You Start
- You need the Admin role or the Manage Users permission.
- Have the email address of each person you want to invite.
- Users, roles and service accounts all live on one page: open the user menu (top right) and select Users. The page has three tabs: Users, Roles and Service Accounts.
Decisions to Make
List the jobs on your team and what each needs. Foreman has one fixed role, Admin, which can do everything. For everyone else, build your own roles. Some common examples:
| Example role | Typical permissions |
|---|---|
| Site technician | Reboot Miners, Restart Miners, Blink LEDs, View Site Map, Edit Tickets |
| Operations lead | The technician permissions, plus Change Pools, Edit Triggers, Change Power Mode |
| Analyst or investor | View Reports, View Financials, with no permissions that change miners |
These are suggestions, not built-in roles. Every permission is described in Quick Guide: Roles And Permissions.
Step 1: Create Your Roles
- On the Users page, open the Roles tab and click Add Role.
- Name the role, then tick the permissions it needs. Permissions are grouped by area, such as Miners, Pools, Power Control, Tickets and Triggers.
- If you manage sub-clients, decide whether to tick Sync Role To Sub-Clients so the role is available there too.
- Save the role.
Step 2: Invite Your Team
- On the Users tab, click Invite Users.
- Enter one or more email addresses, separated by commas, and send the invite.
- Once they've accepted, assign each person their role.
Invitations expire after 3 days and can only be accepted by a Foreman account registered to the invited email address. Full steps: How To: Invite Users And Assign Roles.
Step 3: Secure Your Account
- Two-factor authentication: each person can set it up under My Account > Two Factor Authentication (see How To: Set Up Two-Factor Authentication). To require it for everyone, turn on Require Two Factor in Settings > Company Settings.
- Audit Log: open the user menu and select Audit Log to see who changed what. This needs the View Audit Logs permission.
- Access reviews: use Export Users and Export Roles on the Users page to get a CSV of who has what access.
- Removing access: when someone leaves, remove them from the Users tab right away.
Done When
- ☐ Each job on your team has a role with only the permissions it needs.
- ☐ Everyone has their own login with the right role. No shared logins.
- ☐ You've decided whether to require two-factor authentication.
Next
You've finished Learning Path 1. Continue with Learning Path 2, Module 1: Map Your Site.
Last verified: November 19, 2026