Clever Tools 5.0

[davlgd]

📝 Summary

This PR adds an entry about Clever Tools 5.0

🧪 Type of Change

• ⚠️ Bug fix
• 📅 Changelog update
• 📚 Documentation update
• ✨ New content/feature
• 🔧 Technical/maintenance

✅ Validation

• Read the contributing guidelines
• Verify content accuracy and links
• Run relevant checks and builds
• Check the rendered result when the change affects layout or formatting

[github-actions]

👋` Review app deleted

You closed this PR and deleted the review app.

[Copilot]

🟡 Changes recommended

Unresolved moderate documentation inconsistencies and incomplete update instructions remain.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

This PR documents Clever Tools 5.0 through release notes, updated CLI guidance, installation instructions, observability documentation, and regenerated references.

Changes:

• Adds Node.js 24, system Git, proxy/TLS, drain, and access-log documentation.
• Refreshes CLI examples for applications, services, Kubernetes, notifications, and observability.
• Updates installation guidance, API token documentation, and CLI reference generation.

File summaries

File	Description
update-cli-reference.sh	Regenerates tagged CLI references.
content/doc/tips-and-tricks.md	Updates CLI examples.
content/doc/manage/cli/services-depedencies.md	Documents service dependency commands.
content/doc/manage/cli/profiles.md	Adds profile inspection commands.
content/doc/manage/cli/operators.md	Updates operator workflows.
content/doc/manage/cli/notifications-webhooks.md	Refreshes notification and webhook usage.
content/doc/manage/cli/network-groups.md	Updates Network Group guidance.
content/doc/manage/cli/logs-drains.md	Documents drain types and Splunk.
content/doc/manage/cli/kv-stores.md	Expands KV command examples.
content/doc/manage/cli/kubernetes.md	Updates Kubernetes CLI guidance.
content/doc/manage/cli/install/update.md	Adds installation update instructions.
content/doc/manage/cli/install/nexus-config.md	Updates package repository guidance.
content/doc/manage/cli/install/_index.md	Refreshes installation methods.
content/doc/manage/cli/applications/deployment-lifecycle.md	Documents system Git and access logs.
content/doc/manage/cli/applications/configuration.md	Updates configuration examples.
content/doc/manage/cli/applications/_index.md	Updates application option formatting.
content/doc/manage/cli/addons.md	Updates add-on commands and options.
content/doc/manage/cli/_index.md	Adds TLS and proxy guidance.
content/doc/find-help/faq.md	Updates backup command usage.
content/doc/develop/observability/logs.md	Documents expanded log filters.
content/doc/develop/observability/drains.md	Adds drain types and examples.
content/doc/develop/observability/access-logs.md	Documents TCP and SSH access logs.
content/doc/deploy/services/otoroshi.md	Updates Otoroshi version commands.
content/doc/deploy/services/metabase.md	Updates Metabase version commands.
content/doc/cli-reference.md	Regenerates the CLI reference.
content/changelog/2026/09-11-clever-tools-5.0.md	Announces Clever Tools 5.0.
content/api/_index.md	Updates API token instructions.

Review details

Suppressed comments (6)

content/changelog/2026/09-11-clever-tools-5.0.md:22

• current Active LTS is a time-dependent status that will become stale as Node.js releases change. State the Node.js 24 requirement without this current-status claim to keep the changelog timeless.

Clever Tools now runs on Node.js 24, the current Active LTS. If you install the package with npm, pnpm or Yarn, upgrade Node.js to version 24 or later first. Standalone binaries embed their own Node.js runtime, so this change doesn't affect them.

content/doc/manage/cli/install/_index.md:22

• Use an npm package here; npm is pronounced with a vowel sound.

Clever Tools is available as a npm package, through package managers, or as a standalone binary on many systems:

content/doc/manage/cli/install/_index.md:50

• Use an npm package here; npm is pronounced with a vowel sound.

Clever Tools is available as [a npm package](https://www.npmjs.com/package/clever-tools), which requires Node.js 24 or later. Install it globally with the package manager you use.

content/doc/manage/cli/kubernetes.md:202

• The deployment guide says autoscaling is opt-in and requires --autoscaling --min N --max N (content/doc/deploy/kubernetes/_index.md:65), but this sentence says that supplying the bounds alone enables it. Users following this instruction would configure limits without enabling the autoscaler.

When creating a node group, `--autoscaling` requires both `--min` and `--max`. Supplying both bounds also enables autoscaling without `--autoscaling`.

content/doc/manage/cli/notifications-webhooks.md:28

• --list-all is required when listing an organisation's notifications: the CLI documents it as listing all notifications for an organisation together with --org. With only --org, this example does not demonstrate listing the organisation's notifications; pass both flags.

clever webhooks --org platform-team

update-cli-reference.sh:66

• The generated reference still contains docker run --rm clever-tools <command> from the upstream document, while the published image is clevercloud/clever-tools and the install page in this PR fixes that invocation. This normalization only fixes the link text, so regeneration leaves a non-working Docker example; update the upstream source or normalize the command as well.

      $line =~ s{If you are using docker, use the image provided \[here\]\((https://hub\.docker\.com/[^)]+)\)}{If you are using Docker, use the [Clever Tools image from Docker Hub]($1)};

• Files reviewed: 27/27 changed files
• Comments generated: 3
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[davlgd]

Approved async