Server Management

Commands for starting, stopping, checking status, and viewing logs of the Evonic Flask server.

evonic start

Start the Flask server.

evonic start [--port PORT] [--host HOST] [--debug] [-f]

Flag	Required	Description
--port	No	Port number (default: from config or 8080)
--host	No	Host to bind (default: 0.0.0.0)
--debug	No	Enable debug mode
-f, --foreground	No	Run server in foreground (blocking mode)

Example:

# Start on default port
evonic start

# Start on custom port
evonic start --port 9000

# Start in foreground with debug mode
evonic start -f --debug

Output:

Server started (PID: 12345)
Host: 0.0.0.0
Port: 8080
URL: http://localhost:8080

evonic stop

Stop the running server.

evonic stop

Example:

evonic stop

Output:

Sending SIGTERM to server (PID: 12345)...
Server stopped (PID: 12345)

evonic status

Check if the server is running.

evonic status

Example:

evonic status

Output (running):

Server is running (PID: 12345)
Port: 8080
URL: http://localhost:8080

Output (not running):

Server is not running (no PID file)

evonic update

Check for and apply updates from the Git remote. Requires the update supervisor to be set up first.

evonic update [--check] [--tag TAG] [--rollback] [--force]

Flag	Description
--check	Fetch tags and report what is available — no update is applied
--tag TAG	Update to a specific tag instead of the latest
--rollback	Roll back to the previous stable release
--force	Skip SSH signature verification (development only)

Examples:

# Check what version is available
evonic update --check

# Trigger an immediate update check on the running supervisor
evonic update

# Update to a specific tag
evonic update --tag v1.3.0

# Roll back to the previous release
evonic update --rollback

When the update supervisor is running in the background, evonic update signals it via SIGUSR1 to trigger an immediate check. If the supervisor is not running, the update is performed inline in the current process.

See also: Update System guide

---

Next Steps

• Agent Management
• Skill Management