Skip to content

Repository files navigation

Fleet WebUI

An independent web console for Rancher Fleet, built with Go and React.

Features

  • Browse Bundles, GitRepos, Clusters and BundleDeployments.
  • View Fleet controller and WebUI versions in the sidebar.
  • Inspect Desired/Live YAML, diffs, events and container logs.
  • Reconcile Bundles, sync GitRepos, and pin or resume revisions.
  • View Git history, including private repositories.
  • Compare Bundle × Cluster deployments in a matrix, filtered by workspace, ClusterGroup and cluster labels.
  • Follow repository → Bundle → cluster deployment → resource → Pod diagnostics.
  • Track manual Bundle reconciles and repository syncs through to their observed outcomes, with optional browser notifications.

See the operations guide for deployment state, sync tracking and session limits.

Screenshots

Bundles overview

Bundle details

Run locally

Requires Go 1.27+, Node.js 22.12+, npm and a kubeconfig for a cluster running Fleet.

LISTEN_ADDR=127.0.0.1:8080 \
RECONCILE_ENABLED=false GIT_REPO_ACTIONS_ENABLED=false make run

Open localhost:8080. This starts in read-only mode using $KUBECONFIG or ~/.kube/config.

To choose another file or context, set FLEET_KUBECONFIG and FLEET_KUBECONTEXT. See the configuration guide for other connection options and feature switches.

Deploy

Use the Helm chart or the read-only Kubernetes manifest. Container images and chart installation instructions are covered in the release guide.

Fleet WebUI shares one server-side identity across visitors and has no built-in login. Deploy behind authenticated private access; see Security.

Development

The Go module, source and tests live in server/; the React source lives in frontend/. Frontend builds write to server/dist/, which is embedded in the Go binary. Run the following commands from the repository root:

make build  # Build a standalone binary
make test   # Build the frontend, run Go tests and go vet
make image  # Build a local linux/amd64 container image

For frontend development, start the Go server and run npm --prefix frontend run dev in another terminal.

After building the frontend, Go commands can also run directly in server/, for example go -C server test ./... from the repository root.

Contributing · Releases · Changelog · MIT license · Third-party notices

About

An independent web console for Rancher Fleet, built with Go and React

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages