This manual provides a complete operational reference for CARINA OS. It covers system architecture, daily operations, troubleshooting, and maintenance procedures.
CARINA OS is a layered system built on Ubuntu LTS:
| Layer | Component | Purpose |
|---|---|---|
| 1 | Ubuntu LTS Base | Foundation OS with kernel and core libraries |
| 2 | CARINA Identity | Custom /etc/os-release and /etc/motd branding |
| 3 | CARINA CLI | System management commands (carina doctor, carina profile) |
| 4 | Profiles | Package bundles and configuration scripts |
| 5 | First-Boot | YAML-based initial configuration system |
# Bootstrap CARINA on a fresh Ubuntu 24.04 server
sudo ./bootstrap/bootstrap-carina.sh
# Verify installation
carina doctor
# Check version
carina version
| Command | Description |
|---|---|
carina doctor |
Run system health checks |
carina version |
Display current CARINA version |
carina profile list |
List available profiles |
carina profile apply <name> |
Apply a system profile |
carina gui enable |
Enable graphical interface (FlightDeck) |
carina gui disable |
Disable graphical interface |
carina sandbox templates |
List sandbox templates |
carina sandbox up <template> |
Start a sandbox environment |
carina sandbox list |
Show active sandboxes |
carina sandbox exec <id> <cmd> |
Execute command in sandbox |
carina sandbox down <id> |
Stop and remove a sandbox |
carina sandbox cleanup |
Remove expired sandboxes |
carina missionlab status |
Check MissionLab toolchain status |
carina missionlab devices |
Detect connected development devices |
CARINA Sandbox provides fast, disposable execution environments using Podman containers.
carina sandbox up python --ttl 30m --name my-test
carina sandbox exec my-test python --version
carina sandbox exec my-test bash
carina sandbox down my-test
carina sandbox cleanup
See Sandbox documentation for full details.
MissionLab provides embedded development tooling for microcontrollers and robotics.
carina missionlab status
carina missionlab devices
See MissionLab documentation for full details.
# Sandbox activity log
cat /var/log/carina/sandbox.log
# CARINA Control log
cat /var/log/carina-control.log
# System journal
journalctl -u carina-firstboot
"Permission denied" on serial port:
groupssudo usermod -aG dialout $USERDevice not detected:
lsusbls -la /dev/ttyUSB* /dev/ttyACM*sudo udevadm control --reload-rules && sudo udevadm triggerGUI not starting after enable:
carina profile listsystemctl status gdm3sudo rebootRelated: Getting Started, Features, Administration