Setting Up a Miner

Open the Miners page in the dashboard and click Add Miner. Copy the registration token shown in the modal. That token attaches the new miner to your account.

Navigate to Downloads in the sidebar and choose either the Docker image or the compiled binary for your platform.

Copy .env.template to .env and set the required environment variables for your miner:

• BACKEND_URL - The Elis backend URL, like http://localhost:8000
• MINER_REGISTRATION_TOKEN - The token generated from the dashboard
• MINER_BACKEND - openai, ollama, or stub
• OPENAI_API_KEY - Your OpenAI key when using the OpenAI backend
• OPENAI_MODEL - The model to serve, like gpt-5-mini
• WORKER_ID - A display name for this miner instance

For Ollama miners, set OLLAMA_HOST and MODEL_NAME instead of the OpenAI variables.

MINER_ENROLLMENT_SECRET remains available for legacy or admin-managed deployments, but account-linked registration tokens are the recommended path.

Windows: double-click run.bat. It creates a virtual environment and installs dependencies automatically.

Linux / Docker: load the image and run it:

docker load < elis-miner-linux-x86_64.tar.gz
docker run -d --env-file .env --name elis-miner elis-miner:latest

The miner enrolls on startup, attaches to the account that issued the registration token, and opens a WebSocket connection for heartbeats and job dispatch.

Return to the Miners page. Your new miner should appear in your account-scoped list with its model, status, and last heartbeat.