Settings
The Settings page provides system administration controls for MiningOS, including worker management and user access configuration. Access Settings from the navigation sidebar.
For initial system configuration and superAdmin setup, see the Installation Guide.
Dashboard
The Sidebar can be expanded or collapsed; in either case the user can navigate to the main pages or subpages in MiningOS.
Reboot MiningOS
The Reboot MiningOS feature restarts all the device communication workers. This should help when any one type of device information goes missing in MiningOS. Use this feature to try to fix communication issues, and contact the MiningOS team if it does not work.
This action restarts the worker processes that communicate with physical devices via RPC over Hyperswarm. For details on the worker architecture, see Architecture — System Components.
This is a double-authorization action. See Requests & Approvals for details on the authorization workflow.
There shouldn't be any pending actions in the Actions Chart when rebooting MiningOS. Please submit or discard all other actions before submitting the request to reboot MiningOS.
The reboot action should not be used to try to fix any slowness issues or when devices themselves are having issues. For device-specific troubleshooting, see the Alerts Manual.
When to Reboot
Single device type missing data
Reboot MiningOS
All devices missing data
Check network connectivity first, then reboot
Slowness or UI lag
Do not reboot — contact support
Individual device offline
Troubleshoot device via Explorer
Worker registration issues
Check Orchestrator status
For backend-level troubleshooting, see Backend Operations.
User Management
Go to Settings > User management to manage user accounts and permissions.
Change a user's role by selecting on the Role dropdown, or create and assign a role to a new user by clicking on Add User.
User Roles
Admins
Create/Remove all types of users; authorize double-authorization actions such as Reboot MiningOS. Full access to all Backend Operations.
Site managers
Authorize double-authorization actions such as Reboot MiningOS. See Requests & Approvals.
Site operators
Operate single-authorization actions only. Double-authorization actions require approval from Admins or Site managers.
Read-only users
Access all pages without submitting any actions.
Developers
Same as Read-only users—access all pages without action permissions.
Field operators
Read-only access with permission to add Comments to devices.
Reporting Tool managers
Access limited to Dashboard and Reporting Tool pages only.
Role Capabilities Matrix
View all pages
✓
✓
✓
✓
✓
Single-auth actions
✓
✓
✓
✗
✗
Approve double-auth
✓
✓
✗
✗
✗
Manage users
✓
✗
✗
✗
✗
Add comments
✓
✓
✓
✓
✗
Configure pools
✓
✓
✓
✗
✗
Access inventory
✓
✓
✓
✓
✓
Modify inventory
✓
✓
✓
✗
✗
For pool configuration permissions, see Pool Manager Module.
Initial User Setup
The initial superAdmin user is configured during installation in the config/facs/auth.config.json file. See the Installation Guide for details on:
Setting the superAdmin email address
Configuring OAuth2 authentication providers
Setting up callback URIs for the authentication flow
Adding New Users
Navigate to Settings > User management
Click Add User
Enter the user's email address (must match their OAuth provider email)
Select the appropriate role based on their responsibilities
Click Save
The user will be able to log in using the configured OAuth2 provider (e.g., Google) on their next visit.
Role Selection Guidelines
System administrators
Admin
Full system control including user management
Site supervisors
Site Manager
Can approve actions without user management
Daily operators
Site Operator
Execute routine operations with approval for critical actions
Maintenance technicians
Field Operator
Document observations without operational control
Auditors/Observers
Read-only
Monitor without affecting operations
Integration developers
Developers
Read access for building integrations
Related Documentation
Operator Manual
Requests & Approvals — Authorization workflow for single and double-auth actions
Header — Actions Chart and pending actions indicators
Backend Operations — System commands available to administrators
Comments — Adding device comments (Field operators)
Alerts Manual — Troubleshooting device communication issues
Pool Manager Module — Pool configuration permissions
Inventory Module — Inventory access by role
Operational Best Practices — Recommended procedures
Architecture & Installation
Architecture — System design, workers, and RPC communication
Architecture — App Node — Authentication and authorization gateway
Installation Guide — Initial setup and superAdmin configuration
Installation — App Node Configuration — OAuth2 and auth settings
Contributor Guide
Repository Structure — Understanding the codebase layout
Contribution Workflow — How to contribute to MiningOS
Last updated