[brahimrizq]

What is this PR about?

Adds a Swarm Secrets guide under Core > Advanced, right after Cluster. The Cluster and Docker Compose pages link to it.

The guide explains the Viewing server selector: managers in one Swarm share secrets, while separate Swarms have separate secret stores. Workers can receive mounted secrets but cannot manage them.

The guide shows how to create secrets, copy their names, use them in a Stack deployment, check service usage, rotate them, and delete unused secrets. It explains Current and Rollback references, zero-replica services, and why Docker cannot return or edit a secret's content.

The MySQL example uses environment variables for existing secret names and mounts both password files. It also explains that external: true belongs to the stack configuration.

Companion feature: Dokploy/dokploy#5943
Feature proposal: Dokploy/dokploy#5942

Publication depends on the feature above. Publish this guide when the implementation is accepted and the dashboard feature is available.

Checklist

• Created a separate branch from this repository's main branch.
• Read this repository's contribution instructions in README.md and the main Dokploy contribution guide.
• Used the existing docs layout and components.
• Tested the production docs locally.
• Kept screenshots on a separate evidence branch.

Testing

• pnpm install --frozen-lockfile
• pnpm biome ci
• pnpm typecheck
• pnpm --filter=docs run types:check
• pnpm run docs:build
• Seven browser checks passed, including the sidebar position, links from Cluster and Docker Compose, code rendering, and mobile layout. No browser page errors.
• docker stack config resolved both external secret names and kept both mounts. It rejected either missing name variable. This check did not deploy anything.

The latest update adds six lines about multiple servers. MDX generation and the docs type check passed again. The related feature also passed 16 live Vagrant multi-server checks.

All checks above passed with Node 24.22.1 and pnpm 10.22.0. No dependency or lockfile changes.

Validation results

Screenshots