mirror of
https://github.com/rcourtman/Pulse.git
synced 2026-10-19 02:28:59 +00:00
docs: document container lifecycle actions and the --enable-commands requirement
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
parent
eb665b2a0d
commit
bf6dfe320c
2 changed files with 20 additions and 1 deletions
|
|
@ -220,6 +220,25 @@ You can also toggle "Hide Docker Update Buttons" from the UI in **Settings → S
|
|||
|
||||
---
|
||||
|
||||
## ▶️ Container Lifecycle Actions
|
||||
|
||||
Pulse can start, stop, and restart Docker / Podman containers directly from the UI. Running containers offer **stop** and **restart**; stopped containers offer **start**.
|
||||
|
||||
### Requirements
|
||||
|
||||
- **Pulse Agent** installed on the container host (see [Unified Agent](UNIFIED_AGENT.md)) and currently connected
|
||||
- **Command execution enabled** on the agent — it is disabled by default. Either:
|
||||
- start the agent with `--enable-commands` (or `PULSE_ENABLE_COMMANDS=true`), or
|
||||
- tick **Enable Pulse command execution** in **Settings → Infrastructure** before copying the install command, which adds the flag and grants the token the command execution permission
|
||||
- **Admin approval**: every lifecycle action requires confirmation by an admin in the UI before it runs. The agent then verifies the container's state before the change and confirms it actually reached the requested state afterwards.
|
||||
|
||||
### Limitations
|
||||
|
||||
- If the Docker daemon has **authorization plugins** configured, Pulse blocks all daemon-mutating commands on that host (see advisory GO-2026-4887) and the lifecycle buttons are not offered. Podman hosts are not affected.
|
||||
- Actions are unavailable while the host's Docker inventory is stale or the agent is disconnected.
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ Troubleshooting
|
||||
|
||||
- **Forgot Password?**
|
||||
|
|
|
|||
|
|
@ -102,7 +102,7 @@ curl -fsSL http://<pulse-ip>:7655/install.sh | \
|
|||
| `--enable-kubernetes` | `PULSE_ENABLE_KUBERNETES` | Enable Kubernetes metrics | `false` (installer auto-detect if not configured) |
|
||||
| `--enable-proxmox` | `PULSE_ENABLE_PROXMOX` | Enable Proxmox integration | `false` |
|
||||
| `--proxmox-type` | `PULSE_PROXMOX_TYPE` | Proxmox type: `pve` or `pbs` | *(auto-detect)* |
|
||||
| `--enable-commands` | `PULSE_ENABLE_COMMANDS` | Enable AI command execution (disabled by default) | `false` |
|
||||
| `--enable-commands` | `PULSE_ENABLE_COMMANDS` | Enable Pulse command execution: Docker / Podman container actions from the UI (start/stop/restart/update), Patrol actions, and Proxmox LXC Docker inventory (disabled by default) | `false` |
|
||||
| `--disable-commands` | `PULSE_DISABLE_COMMANDS` | **Deprecated** (commands are disabled by default) | - |
|
||||
| `--disk-exclude` | `PULSE_DISK_EXCLUDE` | Device name/path or mount point patterns to exclude from disk and S.M.A.R.T. monitoring (repeatable or CSV) | *(none)* |
|
||||
| `--kubeconfig` | `PULSE_KUBECONFIG` | Kubeconfig path (optional) | *(auto)* |
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue