This is the full list of permissions you can give a role in Foreman, grouped as they appear in the role editor. Use it when you build roles for your team. For the steps to invite users and create roles, see How To: Invite Users And Assign Roles.
Where to find it: open the user menu (top right) and select Users, then the Roles tab. Click Add Role, or Edit on an existing role.
Who can manage roles: users with the Admin role or the Manage Users permission. The Allow Role Creation setting in Settings > Company Settings controls whether new roles can be created on a client.
Roles
- Admin is a fixed role that can do everything. It can't be edited.
- Every other role is custom: you name it and choose its permissions. A user can have more than one role.
- Service accounts (used by Pickaxe and integrations) get roles the same way, on the Service Accounts tab.
- Use Export Roles to download a CSV listing each role and its permissions, one row per role and permission. Group owners get every sub-client in one file, which is useful for access reviews and audits.
Role Properties
| Property | What it does |
|---|---|
| Sync Role To Sub-Clients | Makes the role available on all sub-clients, so you define it once. |
| Automatically Add Access to Sub-Clients | Gives users with this role access to sub-clients automatically. Available when the role is synced. |
| Sync Role Assignments To Sub-Clients | Keeps who has this role the same on every sub-client. Available when the role is synced. |
Permissions
View permissions let someone see a page. Edit and action permissions let them change settings or send commands to miners. Give command permissions, especially pool, password and factory reset permissions, only to people you trust with your hash rate.
| Group | Permission | What it allows |
|---|---|---|
| Firmware tools | Advanced Thermal Management | Set temperature thresholds and LuxOS ATM settings on miners. |
| Firmware tools | Install Custom Firmware | Install custom firmware on miners. |
| Firmware tools | Uninstall Custom Firmware | Remove custom firmware from miners. |
| Firmware tools | No PIC Protection Mode | Change No PIC Protection Mode on supported custom firmware. |
| Dashboard | Edit Dashboard Pages | Open Page Builder and add, remove, resize or move dashboard tiles. |
| Infrastructure | View Infrastructure | See the Infrastructure page and devices. |
| Infrastructure | Edit Infrastructure | Add, edit and remove infrastructure devices, such as PDUs and switches. |
| Infrastructure | External Device Control | Send commands to infrastructure devices, such as turning PDU outlets on or off. |
| Inventory & Assets | Edit Assets | Create and edit assets. |
| Inventory & Assets | Asset Manager | Manage asset settings, such as asset types and fields. |
| Inventory & Assets | Edit Inventory | Create and edit inventory items. |
| Inventory & Assets | Inventory Manager | Manage inventory settings, such as inventory types and fields. |
| Inventory & Assets | Manage Cycle Counts | Set up and run cycle counts. |
| Issues | Issue Manager | Open Manage Issues to create custom issues and issue groups, and deactivate system issues. |
| Management | Edit Company Settings | Change company settings, such as company label, power pricing and pool API keys. |
| Management | Firmware Manager | Manage the firmware list in Settings > Firmware. |
| Management | Integrations Manager | Manage integrations in Settings, such as MiningRigRentals. |
| Management | Manage Users | Invite and remove users, assign roles, and manage roles and service accounts on the Users page. |
| Management | Sub-Client Admin | Manage settings for sub-clients. |
| Miner Logs | Fetch Miner Logs | Request logs from a miner. |
| Miner Logs | View Miner Logs | View logs that have been fetched, and use log search. |
| Miner Tuning | Adjust Frequency | Change miner frequency. |
| Miner Tuning | Change Autotuning | Turn autotuning on or off. |
| Miner Tuning | Change Cooling Mode | Change cooling mode (for example air or immersion). Custom firmware only. |
| Miner Tuning | Change Overclock | Change performance profiles beyond Normal and Sleeping. |
| Miner Tuning | Fan Mode | Change fan settings. |
| Miner Tuning | Hashrate Target | Set a hash rate target. |
| Miner Tuning | Power Target | Set a power (wattage) target. |
| Miner Tuning | Temp Control | Change temperature control settings. |
| Miners | Add Miners | Add miners with Add Miner, Find Miners or Interactive Miner Add. For hosting sites, give this only to administrators, so customers can't add neighboring miners on the same subnet. |
| Miners | Edit Miners | Edit Foreman miner settings (tags, expected ranges, state, power draw) and view the miner's stored management password. |
| Miners | Delete Miner | Delete miner records, including their history. |
| Miners | Edit Miner Custom Fields | Fill in custom field values on miners. |
| Miners | Manage Miner Custom Fields | Create and change custom miner fields in Settings. |
| Miners | Reboot Miners | Reboot miners. |
| Miners | Restart Miners | Restart the mining software on miners. |
| Miners | Firmware Upgrade | Upgrade miners to stock firmware. |
| Miners | Factory Reset Miners | Factory reset miners, which also sets their pools. Give only to trusted people. |
| Miners | Assign Miner Static IP | Move miners from DHCP to static IP addresses. |
| Miners | Open API | Open the API on miners that ship with it closed, such as older Avalons. |
| Pools | Change Pools | Change miners' pools. Give only to trusted people, since pool changes redirect hash rate. |
| Pools | Mining Pool Manager | Manage Settings > Mining Pools, and approve pool change requests when Pool Change Approval is on. |
| Power Control | View Power Controls | See the Power pages: Command Center, Saved Controls and Event History. |
| Power Control | Edit Power Controls | Create, edit and run power events and saved controls. |
| Power Control | Power Control Manager | Manage power control settings and curtailment plans. Give to the people responsible for load-shedding. |
| Power Control | Change Power Mode | Change a miner's power mode (for example sleeping or normal). |
| Reporting | View Reports | See and subscribe to reports. |
| Reporting | Setup Reports | Set up reports for other people, including people outside Foreman. |
| Reporting | View Financials | See earnings and financial tiles, and the Earnings page. |
| Security | View Security | See the Security page, including configured miner passwords and security risks. Give only to trusted people. |
| Security | Change Miner Passwords | Change miners' management console passwords. |
| Security | View Audit Logs | Open the Audit Log from the user menu to see who did what, and when. |
| Security | View Worker Names | See the Workers page and miners' worker names. |
| Site Map | View Site Map | See the Site Map. |
| Site Map | Edit Site Map | Add or remove miners, groups and racks, change placements, and disable locations. |
| Site Map | Blink LEDs | Flash a miner's LEDs so technicians can find it. |
| Tickets | Edit Tickets | Create, edit and delete tickets, and see ticket history. Without it, users can still update the status of tickets they own. |
| Tickets | Close Tickets | Close tickets. |
| Tickets | Tickets Manager | Manage ticket templates, custom fields and diagnoses in Settings. |
| Triggers | View Triggers | See the Alerts & Triggers page. |
| Triggers | Edit Triggers | Create, edit, duplicate and delete triggers. |
Related Articles
- How To: Invite Users And Assign Roles
- How To: Create A Service Account For Pickaxe
- How To: Set Up Two-Factor Authentication
Last verified: November 19, 2026