From 821f3c51612b791caf3c5801512a18686ece1fc0 Mon Sep 17 00:00:00 2001 From: Eric Callahan Date: Sat, 22 Jul 2023 06:17:45 -0400 Subject: [PATCH] docs: note unixsocket commandline option Signed-off-by: Eric Callahan --- docs/changelog.md | 1 + docs/installation.md | 17 +++++++++++++---- 2 files changed, 14 insertions(+), 4 deletions(-) diff --git a/docs/changelog.md b/docs/changelog.md index 615ae12..91cf5e4 100644 --- a/docs/changelog.md +++ b/docs/changelog.md @@ -19,6 +19,7 @@ The format is based on [Keep a Changelog]. [Spoolman](https://github.com/Donkie/Spoolman) filament manager. - **update_manager**: Added support for update rollbacks - **update_manager**: Added support for stable `git_repo` updates +- **server**: Added a `--unixsocket` command line option ### Fixed diff --git a/docs/installation.md b/docs/installation.md index 36913d6..d52463c 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -34,7 +34,7 @@ missing one or both, you can simply add the bare sections to `printer.cfg`: path: ~/printer_data/gcodes ``` -### Enabling the Unix Socket +### Enabling Klipper's Unix Domain Socket Server After Klipper is installed it may be necessary to modify its `defaults` file in order to enable the Unix Domain Socket. Begin by opening the file in your @@ -326,7 +326,7 @@ This section is intended for users that need to write their own installation script. Detailed are the command line arguments available to Moonraker: ``` -usage: moonraker.py [-h]p [-d ] [-c ] [-l ] [-n] +usage: moonraker.py [-h] [-d ] [-c ] [-l ] [-u ] [-n] [-v] [-g] [-o] Moonraker - Klipper API Server @@ -335,9 +335,11 @@ options: -d , --datapath Location of Moonraker Data File Path -c , --configfile - Location of moonraker configuration file + Path to Moonraker's configuration file -l , --logfile - log file name and location + Path to Moonraker's log file + -u , --unixsocket + Path to Moonraker's unix domain socket -n, --nologfile disable logging to a file -v, --verbose Enable verbose logging -g, --debug Enable Moonraker debug features @@ -348,6 +350,7 @@ The default configuration is: - `data path`: `$HOME/printer_data` - `config file`: `$HOME/printer_data/config/moonraker.conf` - `log file`: `$HOME/printer_data/logs/moonraker.log` +- `unix socket`: `$HOME/printer_data/comms/moonraker.sock` - logging to a file is enabled - Verbose logging is disabled - Moonraker's debug features are disabled @@ -358,6 +361,12 @@ The default configuration is: always be included for new installations. This allows Moonraker to differentiate between new and legacy installations. +!!! Warning + Moonraker's `--unixsocket` option should not be confused with Klipper's + `--api-server` option. The `unixsocket` option for Moonraker specifies + the path where Moonraker will create a unix domain socket that serves its + JSON-RPC API. + If is necessary to run Moonraker without logging to a file the `-n` option may be used, for example: ```