Service Reference

Complete reference for all MuleCube services, ports, and configurations.

Service Overview

MuleCube runs 30+ services organized into categories:

Port Reference

Public Services (User-Facing)

Control Panel Services

Internal Services (APIs/Backend)

Service Details

Knowledge Services

Kiwix (Wikipedia)

Content location: /srv/kiwix/data/*.zim

Add content:

cp new_content.zim /srv/kiwix/data/
cd /srv/kiwix && docker compose restart

Tileserver (Maps)

Supported formats: .mbtiles, .pmtiles

Calibre Web

Default login: admin / admin123 (change immediately)

AI Services

Ollama

Manage models:

# List models
docker exec ollama ollama list

# Pull model
docker exec ollama ollama pull phi3:mini

# Remove model
docker exec ollama ollama rm model_name

Open WebUI

Environment variables:

• OLLAMA_BASE_URL=http://ollama:11434
• WEBUI_AUTH=false (no login required by default)

LibreTranslate

API usage:

curl -X POST http://192.168.42.1:5000/translate \
  -H "Content-Type: application/json" \
  -d '{"q":"Hello","source":"en","target":"es"}'

Productivity Services

CryptPad

Document types: Rich text, Spreadsheet, Presentation, Kanban, Code, Whiteboard

HedgeDoc

Features: Markdown, Real-time collaboration, Slide mode

Excalidraw

Note: Stateless - drawings saved in browser/export

Vaultwarden

Admin panel: http://192.168.42.1:8000/admin

Bitwarden apps: Point to http://192.168.42.1:8000

Stirling PDF

Capabilities: Merge, split, compress, convert, OCR, sign

IT Tools

Tools included: Encoders, converters, generators, network tools

Communication Services

Meshtastic Web

Requirements: Meshtastic-compatible radio hardware

Conduit (Matrix)

Client: Element at same installation or any Matrix client

Syncthing

Media Services

Jellyfin

Directory structure:

media/
├── movies/
├── tv/
├── music/
└── photos/

File Browser

Default login: admin / admin

Infrastructure Services

Pi-hole

Set password:

docker exec -it pihole pihole -a -p

Custom DNS: Edit /srv/pihole/etc-pihole/custom.list

nginx Proxy

Reverse proxy for all services.

Beszel (Monitoring)

Metrics: CPU, memory, disk, network, containers

Uptime Kuma

Monitors: Service health, response times, notifications

Control Panel Services

hw-monitor

Endpoints:

• GET /api/temperature - CPU temp, throttling
• GET /api/battery - UPS status
• GET /api/system - Combined status
• POST /api/reboot - Trigger reboot
• POST /api/shutdown - Trigger shutdown

wifi-status

Endpoints:

• GET /api/clients - Connected WiFi clients
• GET /api/status - AP status

Dockge

Capabilities: Start, stop, restart, logs, compose editing

ttyd (Web Terminal)

Full shell access via browser.

Dozzle (Logs)

Real-time logs for all containers.

Resource Requirements

RAM Usage by Service

Total typical usage: 4-6GB RAM

Storage Usage

Environment Variables

Common environment variables across services:

Docker Networks

All services communicate via the mulecube network.

Volumes & Persistence

Data directories (persistent, excluded from git):

• /srv/*/data/
• /srv/*/config/
• /srv/*/library/

Configuration files (in git):

• /srv/*/docker-compose.yml
• /srv/*/*.toml, *.conf

Starting/Stopping Services

Individual Service

cd /srv/service_name
docker compose up -d      # Start
docker compose stop       # Stop
docker compose restart    # Restart
docker compose down       # Stop and remove
docker compose logs -f    # View logs

All Services

/srv/scripts/start-all.sh
/srv/scripts/stop-all.sh
/srv/scripts/status.sh

Health Checks

Most services have built-in health checks:

# View health status
docker ps --format "table {{.Names}}\t{{.Status}}"

# Check specific service
docker inspect --format='{{.State.Health.Status}}' service_name

Backup Locations

Critical data to backup: