File size: 2,173 Bytes
383cb38 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 | ---
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.
|