#ipc #kvarn

app kvarnctl

Communication with Kvarn from the command line

2 releases

0.1.1 Aug 29, 2022
0.1.0 Apr 24, 2022

#1374 in Command line utilities


2.5K SLoC


Communication with Kvarn from the command line.

kvarnctl takes a command from you and sends it to Kvarn.

The Kvarn instance listening for commands may implement arbitrary commands through the plugin interface.

See the CI on GitHub for Linux downloads.

Custom ctl path

If you configured Kvarn to listen to a custom path, you can specify it using the -p flag. If the path is relative, its base is /run/user/<uid>/ for users and /run/ for root.

Common commands

  • kvarnctl shutdown - this gracefully shuts Kvarn down (if the Kvarn feature graceful-shutdown is enabled)
  • kvarnctl reload - handover to the new binary, located on the same path as the current was started on.
  • kvarnctl ping <message> - test if the Kvarn instance is responsive. It will return <message> and print it to the terminal.
  • kvarnctl wait - waits for Kvarn to shut down
  • kvarnctl clear <method> (<host> <file/URI>) - clears caches. Methods available are all, files, responses, and two which clear a specific resource, file and response.

Platform support

This isn't supported on Windows as it relies on UNIX socket. It's unfeasible we get this working on Windows, as handover isn't possible and the need for remote management on Windows is a very slim market. PRs to kvarn-socket with named pipe support is however welcome :)



  • Update to kvarn_utils = "0.5"


~203K SLoC