Skip to content

MicroDC Worker Setup Guides

This directory contains platform-specific installation guides for the MicroDC Worker.

Quick Start

Platform Guide Method
Ubuntu/Debian UBUNTU_SETUP.md Automated script with systemd service
Windows WINDOWS_SETUP.md Manual install or Windows service

Prerequisites

All platforms require:

  • Python 3.8+ (3.10+ recommended)
  • API Key from MicroDC console
  • Inference Engine (Ollama recommended)

Production Server (Linux)

Use the Ubuntu setup with systemd:

sudo ./ubuntu_setup.sh

This provides:

  • Automatic service management
  • Auto-restart on failure
  • Security hardening
  • Log management via journald

Development Machine

Use manual installation on any platform:

python -m venv venv
source venv/bin/activate  # or .\venv\Scripts\Activate.ps1 on Windows
pip install -e ".[dev]"
python -m src.core.cli start

Windows Server

Use NSSM to run as a Windows service - see WINDOWS_SETUP.md.

Common Configuration

After installation on any platform, you need to configure:

  1. API Key: Your MicroDC worker API key
  2. Server URL: The MicroDC server endpoint
  3. Inference Engine: Ollama URL or other engine settings

Example environment variables:

MICRODC_API_KEY=mdc_wrk_xxxxx
MICRODC_SERVER_URL=https://api.microdc.ai
MICRODC_ENGINE=ollama
OLLAMA_BASE_URL=http://localhost:11434

Ollama Setup

Ollama is the recommended inference engine. Install it on your platform:

Platform Installation
Linux curl -fsSL https://ollama.ai/install.sh \| sh
Windows Download from ollama.ai
macOS brew install ollama or download from ollama.ai

Then pull a model:

ollama pull llama3.1:8b

Next Steps

After installation:

  1. Verify the worker is running: systemctl status microdcworker (Linux) or check Task Manager (Windows)
  2. Check logs for successful registration
  3. Monitor jobs in the MicroDC console

Troubleshooting

Each platform guide includes a troubleshooting section. Common issues:

  • Authentication errors: Verify your API key is correct
  • Connection refused: Check Ollama is running
  • Permission denied: Ensure proper file ownership (Linux)

Additional Resources