python plugins: add note for systemd and uv

backup/README.md

@@ -18,6 +18,28 @@ plugin and `backup-cli` like a binary. After `uv` is installed and you followed
 lightning-cli plugin start /path/to/backup.py
 ```
 
+If you use `systemd` to start CLN, you must have `uv` in the `PATH` that `systemd` uses, which is likely different than the `PATH` from your shell. Most `uv` installation methods install `uv` into your user's home directory (`~/.local/bin` or `~/.cargo/bin`), which `systemd` cannot access.
+
+You can either:
+
+**Option 1: Install `uv` system-wide** (recommended):
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sudo env UV_INSTALL_DIR="/usr/local/bin" sh
+```
+
+**Option 2: Copy your existing user installation**:
+```bash
+sudo cp "$(command -v uv)" /usr/local/bin/uv
+```
+
+**Option 3: Configure your systemd service** to use a custom `PATH` (see systemd documentation).
+
+To verify `uv` is accessible to systemd:
+```bash
+sudo systemd-run --user --wait command -v uv
+```
+This should output `/usr/local/bin/uv`.
+
 For general plugin installation instructions see the repos main
 [README.md](https://github.com/lightningd/plugins/blob/master/README.md#Installation)
 

cl-zmq/README.md

@@ -14,6 +14,28 @@ plugin like a binary. After `uv` is installed you can simply run
 lightning-cli plugin start /path/to/cl-zmq.py
 ```
 
+If you use `systemd` to start CLN, you must have `uv` in the `PATH` that `systemd` uses, which is likely different than the `PATH` from your shell. Most `uv` installation methods install `uv` into your user's home directory (`~/.local/bin` or `~/.cargo/bin`), which `systemd` cannot access.
+
+You can either:
+
+**Option 1: Install `uv` system-wide** (recommended):
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sudo env UV_INSTALL_DIR="/usr/local/bin" sh
+```
+
+**Option 2: Copy your existing user installation**:
+```bash
+sudo cp "$(command -v uv)" /usr/local/bin/uv
+```
+
+**Option 3: Configure your systemd service** to use a custom `PATH` (see systemd documentation).
+
+To verify `uv` is accessible to systemd:
+```bash
+sudo systemd-run --user --wait command -v uv
+```
+This should output `/usr/local/bin/uv`.
+
 For general plugin installation instructions see the repos main
 [README.md](https://github.com/lightningd/plugins/blob/master/README.md#Installation)
 

clearnet/README.md

@@ -12,6 +12,28 @@ plugin like a binary. After `uv` is installed you can simply run
 lightning-cli plugin start /path/to/clearnet.py
 ```
 
+If you use `systemd` to start CLN, you must have `uv` in the `PATH` that `systemd` uses, which is likely different than the `PATH` from your shell. Most `uv` installation methods install `uv` into your user's home directory (`~/.local/bin` or `~/.cargo/bin`), which `systemd` cannot access.
+
+You can either:
+
+**Option 1: Install `uv` system-wide** (recommended):
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sudo env UV_INSTALL_DIR="/usr/local/bin" sh
+```
+
+**Option 2: Copy your existing user installation**:
+```bash
+sudo cp "$(command -v uv)" /usr/local/bin/uv
+```
+
+**Option 3: Configure your systemd service** to use a custom `PATH` (see systemd documentation).
+
+To verify `uv` is accessible to systemd:
+```bash
+sudo systemd-run --user --wait command -v uv
+```
+This should output `/usr/local/bin/uv`.
+
 For general plugin installation instructions see the repos main
 [README.md](https://github.com/lightningd/plugins/blob/master/README.md#Installation)
 

currencyrate/README.md

@@ -12,6 +12,28 @@ plugin like a binary. After `uv` is installed you can simply run
 lightning-cli plugin start /path/to/currencyrate.py
 ```
 
+If you use `systemd` to start CLN, you must have `uv` in the `PATH` that `systemd` uses, which is likely different than the `PATH` from your shell. Most `uv` installation methods install `uv` into your user's home directory (`~/.local/bin` or `~/.cargo/bin`), which `systemd` cannot access.
+
+You can either:
+
+**Option 1: Install `uv` system-wide** (recommended):
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sudo env UV_INSTALL_DIR="/usr/local/bin" sh
+```
+
+**Option 2: Copy your existing user installation**:
+```bash
+sudo cp "$(command -v uv)" /usr/local/bin/uv
+```
+
+**Option 3: Configure your systemd service** to use a custom `PATH` (see systemd documentation).
+
+To verify `uv` is accessible to systemd:
+```bash
+sudo systemd-run --user --wait command -v uv
+```
+This should output `/usr/local/bin/uv`.
+
 For general plugin installation instructions see the repos main
 [README.md](https://github.com/lightningd/plugins/blob/master/README.md#Installation)
 

donations/README.md

@@ -7,6 +7,28 @@ plugin like a binary. After `uv` is installed you can simply run
 lightning-cli plugin start /path/to/donations.py
 ```
 
+If you use `systemd` to start CLN, you must have `uv` in the `PATH` that `systemd` uses, which is likely different than the `PATH` from your shell. Most `uv` installation methods install `uv` into your user's home directory (`~/.local/bin` or `~/.cargo/bin`), which `systemd` cannot access.
+
+You can either:
+
+**Option 1: Install `uv` system-wide** (recommended):
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sudo env UV_INSTALL_DIR="/usr/local/bin" sh
+```
+
+**Option 2: Copy your existing user installation**:
+```bash
+sudo cp "$(command -v uv)" /usr/local/bin/uv
+```
+
+**Option 3: Configure your systemd service** to use a custom `PATH` (see systemd documentation).
+
+To verify `uv` is accessible to systemd:
+```bash
+sudo systemd-run --user --wait command -v uv
+```
+This should output `/usr/local/bin/uv`.
+
 For general plugin installation instructions see the repos main
 [README.md](https://github.com/lightningd/plugins/blob/master/README.md#Installation)
 

feeadjuster/README.md

@@ -14,6 +14,28 @@ plugin like a binary. After `uv` is installed you can simply run
 lightning-cli plugin start /path/to/feeadjuster.py
 ```
 
+If you use `systemd` to start CLN, you must have `uv` in the `PATH` that `systemd` uses, which is likely different than the `PATH` from your shell. Most `uv` installation methods install `uv` into your user's home directory (`~/.local/bin` or `~/.cargo/bin`), which `systemd` cannot access.
+
+You can either:
+
+**Option 1: Install `uv` system-wide** (recommended):
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sudo env UV_INSTALL_DIR="/usr/local/bin" sh
+```
+
+**Option 2: Copy your existing user installation**:
+```bash
+sudo cp "$(command -v uv)" /usr/local/bin/uv
+```
+
+**Option 3: Configure your systemd service** to use a custom `PATH` (see systemd documentation).
+
+To verify `uv` is accessible to systemd:
+```bash
+sudo systemd-run --user --wait command -v uv
+```
+This should output `/usr/local/bin/uv`.
+
 For general plugin installation instructions see the repos main
 [README.md](https://github.com/lightningd/plugins/blob/master/README.md#Installation)
 

historian/README.md

@@ -21,6 +21,28 @@ plugin like a binary. After `uv` is installed you can simply run
 lightning-cli plugin start /path/to/historian.py
 ```
 
+If you use `systemd` to start CLN, you must have `uv` in the `PATH` that `systemd` uses, which is likely different than the `PATH` from your shell. Most `uv` installation methods install `uv` into your user's home directory (`~/.local/bin` or `~/.cargo/bin`), which `systemd` cannot access.
+
+You can either:
+
+**Option 1: Install `uv` system-wide** (recommended):
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sudo env UV_INSTALL_DIR="/usr/local/bin" sh
+```
+
+**Option 2: Copy your existing user installation**:
+```bash
+sudo cp "$(command -v uv)" /usr/local/bin/uv
+```
+
+**Option 3: Configure your systemd service** to use a custom `PATH` (see systemd documentation).
+
+To verify `uv` is accessible to systemd:
+```bash
+sudo systemd-run --user --wait command -v uv
+```
+This should output `/usr/local/bin/uv`.
+
 For general plugin installation instructions see the repos main
 [README.md](https://github.com/lightningd/plugins/blob/master/README.md#Installation)
 

monitor/README.md

@@ -11,6 +11,28 @@ plugin like a binary. After `uv` is installed you can simply run
 lightning-cli plugin start /path/to/monitor.py
 ```
 
+If you use `systemd` to start CLN, you must have `uv` in the `PATH` that `systemd` uses, which is likely different than the `PATH` from your shell. Most `uv` installation methods install `uv` into your user's home directory (`~/.local/bin` or `~/.cargo/bin`), which `systemd` cannot access.
+
+You can either:
+
+**Option 1: Install `uv` system-wide** (recommended):
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sudo env UV_INSTALL_DIR="/usr/local/bin" sh
+```
+
+**Option 2: Copy your existing user installation**:
+```bash
+sudo cp "$(command -v uv)" /usr/local/bin/uv
+```
+
+**Option 3: Configure your systemd service** to use a custom `PATH` (see systemd documentation).
+
+To verify `uv` is accessible to systemd:
+```bash
+sudo systemd-run --user --wait command -v uv
+```
+This should output `/usr/local/bin/uv`.
+
 For general plugin installation instructions see the repos main
 [README.md](https://github.com/lightningd/plugins/blob/master/README.md#Installation)
 

persistent-channels/README.md

@@ -7,6 +7,28 @@ plugin like a binary. After `uv` is installed you can simply run
 lightning-cli plugin start /path/to/persistent-channels.py
 ```
 
+If you use `systemd` to start CLN, you must have `uv` in the `PATH` that `systemd` uses, which is likely different than the `PATH` from your shell. Most `uv` installation methods install `uv` into your user's home directory (`~/.local/bin` or `~/.cargo/bin`), which `systemd` cannot access.
+
+You can either:
+
+**Option 1: Install `uv` system-wide** (recommended):
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sudo env UV_INSTALL_DIR="/usr/local/bin" sh
+```
+
+**Option 2: Copy your existing user installation**:
+```bash
+sudo cp "$(command -v uv)" /usr/local/bin/uv
+```
+
+**Option 3: Configure your systemd service** to use a custom `PATH` (see systemd documentation).
+
+To verify `uv` is accessible to systemd:
+```bash
+sudo systemd-run --user --wait command -v uv
+```
+This should output `/usr/local/bin/uv`.
+
 For general plugin installation instructions see the repos main
 [README.md](https://github.com/lightningd/plugins/blob/master/README.md#Installation)
 

prometheus/README.md

@@ -25,5 +25,27 @@ plugin like a binary. After `uv` is installed you can simply run
 lightning-cli plugin start /path/to/prometheus.py
 ```
 
+If you use `systemd` to start CLN, you must have `uv` in the `PATH` that `systemd` uses, which is likely different than the `PATH` from your shell. Most `uv` installation methods install `uv` into your user's home directory (`~/.local/bin` or `~/.cargo/bin`), which `systemd` cannot access.
+
+You can either:
+
+**Option 1: Install `uv` system-wide** (recommended):
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sudo env UV_INSTALL_DIR="/usr/local/bin" sh
+```
+
+**Option 2: Copy your existing user installation**:
+```bash
+sudo cp "$(command -v uv)" /usr/local/bin/uv
+```
+
+**Option 3: Configure your systemd service** to use a custom `PATH` (see systemd documentation).
+
+To verify `uv` is accessible to systemd:
+```bash
+sudo systemd-run --user --wait command -v uv
+```
+This should output `/usr/local/bin/uv`.
+
 For general plugin installation instructions see the repos main
 [README.md](https://github.com/lightningd/plugins/blob/master/README.md#Installation)

rebalance/README.md

@@ -12,6 +12,28 @@ plugin like a binary. After `uv` is installed you can simply run
 lightning-cli plugin start /path/to/rebalance.py
 ```
 
+If you use `systemd` to start CLN, you must have `uv` in the `PATH` that `systemd` uses, which is likely different than the `PATH` from your shell. Most `uv` installation methods install `uv` into your user's home directory (`~/.local/bin` or `~/.cargo/bin`), which `systemd` cannot access.
+
+You can either:
+
+**Option 1: Install `uv` system-wide** (recommended):
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sudo env UV_INSTALL_DIR="/usr/local/bin" sh
+```
+
+**Option 2: Copy your existing user installation**:
+```bash
+sudo cp "$(command -v uv)" /usr/local/bin/uv
+```
+
+**Option 3: Configure your systemd service** to use a custom `PATH` (see systemd documentation).
+
+To verify `uv` is accessible to systemd:
+```bash
+sudo systemd-run --user --wait command -v uv
+```
+This should output `/usr/local/bin/uv`.
+
 For general plugin installation instructions see the repos main
 [README.md](https://github.com/lightningd/plugins/blob/master/README.md#Installation)
 

sauron/README.md

@@ -41,3 +41,26 @@ Hidden services are also supported :
 ```
 lightningd --testnet --disable-plugin bcli --plugin $PWD/sauron.py --sauron-tor-proxy localhost:9050 --sauron-api-endpoint http://explorerzydxu5ecjrkwceayqybizmpjjznk5izmitf2modhcusuqlid.onion/testnet/api/
 ```
+
+
+If you use `systemd` to start CLN, you must have `uv` in the `PATH` that `systemd` uses, which is likely different than the `PATH` from your shell. Most `uv` installation methods install `uv` into your user's home directory (`~/.local/bin` or `~/.cargo/bin`), which `systemd` cannot access.
+
+You can either:
+
+**Option 1: Install `uv` system-wide** (recommended):
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sudo env UV_INSTALL_DIR="/usr/local/bin" sh
+```
+
+**Option 2: Copy your existing user installation**:
+```bash
+sudo cp "$(command -v uv)" /usr/local/bin/uv
+```
+
+**Option 3: Configure your systemd service** to use a custom `PATH` (see systemd documentation).
+
+To verify `uv` is accessible to systemd:
+```bash
+sudo systemd-run --user --wait command -v uv
+```
+This should output `/usr/local/bin/uv`.

summary/README.md

@@ -13,6 +13,28 @@ plugin like a binary. After `uv` is installed you can simply run
 lightning-cli plugin start /path/to/summary.py
 ```
 
+If you use `systemd` to start CLN, you must have `uv` in the `PATH` that `systemd` uses, which is likely different than the `PATH` from your shell. Most `uv` installation methods install `uv` into your user's home directory (`~/.local/bin` or `~/.cargo/bin`), which `systemd` cannot access.
+
+You can either:
+
+**Option 1: Install `uv` system-wide** (recommended):
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sudo env UV_INSTALL_DIR="/usr/local/bin" sh
+```
+
+**Option 2: Copy your existing user installation**:
+```bash
+sudo cp "$(command -v uv)" /usr/local/bin/uv
+```
+
+**Option 3: Configure your systemd service** to use a custom `PATH` (see systemd documentation).
+
+To verify `uv` is accessible to systemd:
+```bash
+sudo systemd-run --user --wait command -v uv
+```
+This should output `/usr/local/bin/uv`.
+
 For general plugin installation instructions see the repos main
 [README.md](https://github.com/lightningd/plugins/blob/master/README.md#Installation)