Tutorial

Dedicated Miners for an Organization

Assign miners, issue registration tokens, and enforce dedicated-only execution.

1

Open the Miners tab

In organization settings, switch to the Miners tab to view currently assigned dedicated miners and attach new workers.

Miners tab in organization settings
2

Generate a registration token

Click Generate token to create a short-lived registration token for the miner registration endpoint.

Registration token modal or panel
3

Point the miner at your private cluster

For an on-prem or dedicated deployment, configure the miner with your own cluster API origin instead of the shared community endpoint. Use the organization's registration token so the worker enrolls into the correct company context.

BACKEND_URL=https://your-private-api.example
MINER_REGISTRATION_TOKEN=mreg_...
MINER_BACKEND=ollama
MODEL_NAME=phi4-mini
4

Assign or unassign miners

Use assignment actions to link miners to the organization. Unassign when a worker is rotated out for maintenance or ownership changes.

Assign and unassign miner controls
5

Enable dedicated-miners-only mode

Toggle Dedicated Miners Only to hard-enforce organization workers at runtime. Requests fail fast when no assigned miner can serve the selected model, and the scheduler will not fall back to community compute.

Dedicated miners only toggle in settings
Tip:Before enabling dedicated-only mode in production, ensure at least two healthy miners are assigned for each required model to avoid avoidable request failures. For fully private deployments, keep the miners pointed at your private API and use self-hosted models where possible.