metadata
name: atom-start
description: Start Atom OS server (foreground, not daemon)
version: 1.0.0
author: Atom Team
tags:
- atom
- cli
- start
- server
maturity_level: AUTONOMOUS
governance:
maturity_requirement: AUTONOMOUS
reason: Server start manages system resources, requires full autonomy
Atom Server Starter
Start Atom OS server in foreground (not daemon mode).
Usage
Execute this skill to start Atom server:
atom-os start [options]
Options
--port <number>: Port for web server (default: 8000)--host <address>: Host to bind to (default: 0.0.0.0)--workers <count>: Number of worker processes (default: 1)--host-mount: Enable host filesystem mount (requires confirmation)--dev: Enable development mode with auto-reload
Examples
Start server on default port:
atom-os start
Start server on custom port with development mode:
atom-os start --port 3000 --dev
Start server with host mount:
atom-os start --host-mount
Output
Server startup information:
- Edition: Personal or Enterprise
- Host: Binding address
- Port: Server port
- Workers: Number of worker processes
- Dev mode: Enabled/disabled
- Host mount: Enabled/disabled
- Dashboard URL: http://localhost:8000 (or custom port)
- API docs: http://localhost:8000/docs
Notes
⚠️ AUTONOMOUS maturity required - This command manages system resources.
Foreground Mode: This command runs Atom OS in the foreground (not as daemon). Use atom-os daemon for background service.
Host Mount Warning: Enabling --host-mount gives containers write access to host directories. Governance protections active:
- AUTONOMOUS maturity gate required
- Command whitelist (ls, cat, grep, git, npm, etc.)
- Blocked commands (rm, mv, chmod, kill, sudo, etc.)
- 5-minute timeout enforcement
- Full audit trail to ShellSession table
Difference from daemon
atom-os start: Runs in foreground (attached to terminal)atom-os daemon: Runs in background (detached process)
Use start for development/testing, use daemon for production service.