Updated

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

  1. On the Users page, open the Roles tab and click Add Role.
  2. Name the role, then tick the permissions it needs. Permissions are grouped by area, such as Miners, Pools, Power Control, Tickets and Triggers.
  3. If you manage sub-clients, decide whether to tick Sync Role To Sub-Clients so the role is available there too.
  4. Save the role.

Onboarding: Role permissions

Step 2: Invite Your Team

  1. On the Users tab, click Invite Users.
  2. Enter one or more email addresses, separated by commas, and send the invite.
  3. Once they've accepted, assign each person their role.

Onboarding: Invite Users

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

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Can't find what you're looking for?

Our support team can help with setup, hardware and billing questions.

Contact Support