Help
How can we help?
Install Glauco, connect your clusters and learn each screen. Manage your license, and fix common problems. Search below, or browse by topic.
Get started
Install Glauco and connect it to your clusters.
- Install on macOSDownload the DMG, drag Glauco to Applications, and open it.
- Install on WindowsRun the installer. Glauco installs for your user only, with no admin rights.
- Install on LinuxInstall the .deb on Debian or Ubuntu, or the .rpm on Fedora or RHEL.
- First launchHow Glauco finds your kubeconfig files and your auth plugins, and how the trial starts.
Using Glauco
Short guides for each screen and action.
- Connect to and switch clustersPick a context, switch between clusters, and add more kubeconfig files.
- Browse, filter and searchMove between resource kinds, scope to a namespace, filter tables and use the command palette.
- Resource detail: YAML, events, logs and terminalOpen a resource to read its YAML and events, follow logs, exec into a container or forward a port.
- Edit, scale, restart and deleteChange a resource from its detail view. Every change asks you to confirm first.
- Apply YAMLCreate or update objects from a manifest you paste or open.
- Helm releasesSee releases and their history, roll back, uninstall, and set the Helm binary.
- Custom resourcesOpen any custom resource kind from the Custom menu or the command palette.
- Nodes, cordon and drainCheck node capacity, cordon a node, and drain it before maintenance.
- Cluster healthSee crashing pods, failed pulls, unready nodes and other problems on one screen.
- CPU and memory barsHow the usage bars and meters work: usage, requests, limits, percentages and colours.
- History from Prometheus: CPU and memory over timeThe Metrics tab charts CPU and memory over time from the Prometheus in your cluster.
- Copy kubectl commandsCopy a kubectl get, describe, logs or edit command for any resource.
- Keyboard shortcutsEvery shortcut in Glauco, on macOS and on Windows and Linux.
- Light and dark themeSwitch Glauco between a light and a dark theme.
Licenses and billing
The trial, free mode, license keys, installs and billing.
- The trial and free mode14 days with every feature, then free mode: one cluster, read-only, for personal use.
- Activate a license keyOpen the activation link from your email, or enter your key in Settings.
- Installs and seatsHow many computers a license covers, and how to free up an install.
- Offline license files (Enterprise)Activate a computer that cannot reach the internet with a license file.
- Manage billingFind your key, payment, invoices and seats in your account on glauco.app.
Troubleshooting
What an error means and how to fix it.
- gke-gcloud-auth-plugin ENOENT: plugin not foundGlauco cannot run gke-gcloud-auth-plugin, aws, kubelogin or another exec plugin.
- No clusters found: no contexts in your kubeconfigGlauco opens but shows no contexts.
- Metrics unavailable: install metrics-serverThe usage columns show no values because the cluster has no metrics-server.
- helm binary not found: install Helm 3 or laterRollback and uninstall need the helm CLI. Install it or point Glauco to it.
- License and activation errorsWhat each license message means, and what to do.