CLI reference

obraz serve

obraz serve --port PORT

Runs the image service on 127.0.0.1:PORT until it is stopped. The binary carries no port of its own: the unit's env file declares OBRAZ_PORT and the launcher passes it. --port 0 lets the system choose a free port, and the line below prints the port that was bound. The renderer's address, and the image-model service's address, bearer file and model when the deployment names them, are checked before anything is served (see configuration).

obraz listening on http://127.0.0.1:<port>

Refusals

Exit 1, nothing served: the service configuration refusals, and

obraz cannot listen on 127.0.0.1:<port>: <cause>

A service that stops on its own exits 1 with obraz stopped serving: <cause>. A missing --port exits 2.