Quick Guide: Roles And Permissions

Updated

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

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