m3tal-core

README

M3TAL Media Server

Autonomous, self-healing media automation platform.

🏗 Architecture (Source Services)

Service	Type	Path
api	CLI binary	cmd/api
m3tal	CLI binary	cmd/m3tal
api	Go package	internal/api
auth	Go package	internal/auth
config	Go package	internal/config
containers	Go package	internal/containers
engine	Go package	internal/engine
health	Go package	internal/health
orchestrator	Go package	internal/orchestrator
plugin	Go package	internal/plugin
preflight	Go package	internal/preflight
store	Go package	internal/store
system	Go package	internal/system
dashboard	Deploy artifact	deploy/dashboard
plugins	Deploy artifact	deploy/plugins
stack	Deploy artifact	deploy/stack
github.com/jakej985-rgb/m3tal-core	Go module	go.mod

🐳 Infrastructure Stacks

Ai Stack

• ollama (ollama/ollama:latest)
  • Ports: 11434:11434

M3tal Stack

• m3tal-dashboard (ghcr.io/jakej985-rgb/m3tal-godash:debug)

Routing Stack

• traefik (traefik:latest)
  • Ports: 127.0.0.1:8081:8080
• cloudflared (cloudflare/cloudflared:latest)

⚙️ Environment Configuration

Variable	Default
DASHBOARD_PORT	8082
DASHBOARD_EXPOSE_MODE	local
HTTP_PORT	8080
STATE_DIR	./state
LOG_LEVEL	info
DASHBOARD_SECRET	change\_me\_immediately
API_TOKEN	change\_me\_api\_token
ADMIN_PASSWORD	admin\_pass
NETWORK_NAME	m3tal
LOCAL_IP	127.0.0.1
DOMAIN	localhost
VPN_USER	user
VPN_PASSWORD	password
BASE_STORAGE_PATH	./data
MEDIA_PATH	./data/media
CONFIG_PATH	./data/config
DOWNLOADS_PATH	./data/downloads
PUID	1000
PGID	1000
TZ	America/Denver
TRAEFIK_WEB_PORT	80
TRAEFIK_WEBHTTPS_PORT	443
TRAEFIK_DASHBOARD_PORT	8080
DEBUG_MODE	false
METRICS_ENABLED	true

🚀 Deployment

python m3tal.py init