flexx logoflexx docs

System Service

Run flexx as a persistent system service on Linux (systemd) or macOS (launchd). Auto-start on boot.

Install

flexx service install

This creates a service that starts flexx connect automatically on boot.

Linux (systemd)

Creates a user-level systemd unit at ~/.config/systemd/user/flexx-remote.service.

systemctl --user status flexx-remote     # Check status
systemctl --user restart flexx-remote    # Restart
systemctl --user stop flexx-remote       # Stop
journalctl --user -u flexx-remote -f     # View logs

macOS (launchd)

Creates a LaunchAgent at ~/Library/LaunchAgents/dev.flexx.remote.plist.

launchctl list dev.flexx.remote    # Check status

Windows

System service installation is not supported on Windows. Use background mode instead:

flexx connect --daemon

Uninstall

flexx service uninstall

Status

flexx service status

Logs

flexx service logs    # Linux only (via journalctl)

Alternative: background mode

If you don't want a system service, run the daemon in the background:

flexx connect --daemon

Check status with:

flexx status

After updating the CLI

curl | sh and flexx update only replace the binary on disk. Restart the service so the new process loads the new code:

flexx service restart

flexx service install alone is not enough if the unit is already active — on Linux, systemctl start is a no-op when the service is running.

On this page