ODS V3 Pre-Release: Public testing and refinement ahead of the official V3 launch. Turn your PC, Mac, or Linux box into a private AI server.
Python ai-agentsamdcomfyuidockerllama-cppllmlocal-ain8nnvidiaopen-webuiragself-hostedspeech-to-textstrix-halotext-to-speechworkflow-automation
Linux portability
How to run ODS reliably across different Linux machines (with or without a GPU), recover from a bad reinstall, and work with extensions.
Installer
- Entry:
install.sh→install-core.sh— see INSTALLER-ARCHITECTURE.md. - CPU-only systems: With a capability profile, set
CAP_LLM_BACKEND=cpuso the installer keeps CPU inference (see02-detection.sh). - Re-running the installer: If a previous run left directories owned by container users, the installer checks that
config/*anddata/*are writable before copying files, usesrsyncwithout preserving foreign ownership, and tells you tochownif something is still blocked (06-directories.sh). - Fedora/RHEL SELinux: Compose bind mounts use shared
:zlabels so enforcing SELinux can relabel ODS repo/data paths for containers. If you add custom bind mounts on SELinux systems, include:zas well.
Extensions and integrations
Services are declared under extensions/services/<name>/manifest.yaml for dashboard health and feature metadata. Schema: extensions/schema/service-manifest.v1.json. To add or change a service, follow EXTENSIONS.md.
Checklist on a new Linux machine
- Docker and Compose v2 work; your user can run containers (e.g. member of the
dockergroup). ./install.sh --dry-runfinishes without errors.- Before or after install, run
./scripts/linux-install-preflight.sh(or./ods-preflight.sh --install-env) for a structured environment report with stable check IDs and optional--jsonoutput. - After a real install, run
./ods-preflight.sh(service health) andscripts/ods-doctor.shif you use them.
More context: LINUX-TROUBLESHOOTING-GUIDE.md (ID-indexed fixes), FIELD-INSTALL-REPORT-LINUX.md (bug report template), SUPPORT-MATRIX.md, TROUBLESHOOTING.md.
Extension PRs that touch catalog vs core: EXTENSION-PR-BRANCHING.md.