Start from Module 1.1
- Your named agent exists and has already replied.
- ArmaraOS is currently healthy. This lesson will stop it once, then restore it detached.
Avoid the terminal wall
Plain foreground startup belongs to one terminal window. Detached startup belongs to the computer.
Running armaraos start without the flag occupies the terminal. Closing that window ends the foreground process. The --detach flag launches the daemon in the background, returns your prompt, and is documented to survive terminal close.
You do not need to run foreground startup to learn this distinction. Use the reliable detached path throughout the course.
Prove detachment with a new window
Start detached, then remove the terminal that started it.
armaraos start --detach
In the new terminal, ask for the fast health check.
armaraos health
The old window is gone and the service still answers. That is the complete proof of detachment.
Read the full status report
Status adds the provider, model, address, uptime, and agent roster.
armaraos status
Confirm Status: running. The Provider and Model lines should match what you selected in Module 1.1. The API address begins with 127.0.0.1, which means this computer.
Data dir: ? is a cosmetic display defect in 0.8.3, not a broken installation. The Dashboard line names a web surface this CLI course does not teach. It appears in genuine output, so we identify it and move on.
Choose the fast or full check
The two commands agree about health but answer at different depths.
| Command | Use it when | What you get |
|---|---|---|
armaraos health | You need a quick yes or no. | A short health result. |
armaraos status | You need to inspect the running setup. | Service state, provider, model, address, uptime, and agents. |
Both commands also support machine-readable output. Course 2 uses that capability for scripted checks, so there is no need to add those flags yet.
Practice the off switch, then restore service
Know how to stop a service before relying on it.
armaraos stop
Run the fast check again while the daemon is down.
armaraos health
Now restore the state needed for the rest of the course.
armaraos start --detachWait for startup to finish. The module must end with ArmaraOS running detached.
Recognize the gateway alias
The gateway family controls the same daemon through a grouped command.
armaraos gateway status
This course uses the shorter top-level commands as the primary path. Live help confirms that gateway start has no --detach flag, while top-level detached startup does.
Keep live logs in a second window
Watching output should not take ownership of the service.
When you later need live logs, keep the daemon detached and open a second terminal for armaraos logs -f. Module 2.5 teaches that view. Your service remains independent and your working prompt remains available.
Check it / run this yourself
Close the window one more time.
Close the current terminal completely. Open a new one and run the fast check.
armaraos healthA healthy response from the new window proves the daemon is detached. If it is down, run armaraos start --detach and repeat the physical check.
The default daemon listens on localhost and has no daemon password. Another program already running on your computer can also reach localhost. Do not expose port 50051 beyond your machine. Course 7 returns to access control.
Troubleshooting for this sitting
| What you see | Likely cause | What to do |
|---|---|---|
| Health fails after the window closes | The daemon was started in the foreground or never started. | Run armaraos start --detach, wait, and repeat the physical check. |
| Stop says no daemon is running | It was already stopped. | Nothing is damaged. Start it detached. |
Status shows Data dir: ? | Known cosmetic output defect in 0.8.3. | Continue. Module 1.6 locates the real files. |
| The provider or model looks wrong | The Module 1.1 selection did not persist as expected. | Run armaraos models set, then check status again. |
| Startup is still restoring agents | Local startup has not finished. | Wait, then run health before retrying anything. |