mait.sh1.132.1

Private beta: features and content may change. No warranty; use at your own risk.

Operate aide

See what is running and routed, diagnose the host, keep AIDE current, and remove a cluster or AIDE itself.

Beta
Inspect

Clusters, components and routed Services.

CommandUse it toWhat it reports
aide cluster listSee every registered clusterName, domain, status and runtime. Needs no project file
aide cluster statusCheck the project's clusterComponent, DNS and trust indicators
aide cluster use <NAME>Pick the default clusterSets the default cluster and the kubectl context; the name must be a running cluster
aide route listSee routed ServicesServices that carry routing annotations, with mode and endpoint. -n selects the namespace (default apps)
aide route statusCheck overridesThe same list, plus a reachability check of each override

Status indicators describe the cluster, not your application. A green status does not show that a hostname resolves, that the certificate is trusted or that a response body is right; check those with getent hosts and curl.

Diagnose

One report for credentials, tools, updates and connectivity.

aide doctor checks credentials, each managed tool, the privileged helper, update status and whether MAIT services answer. aide setup --check reports only the managed dependencies and exits 1 when one is missing.

Check the managed dependencies
# example output
$ aide setup --check
 
Dependencies
 
NAME VERSION SOURCE STATUS
k3d 5.8.3 aidc missing
kubectl 1.35.3 aidc missing
helm 4.1.4 aidc missing
dnsmasq latest apt installed
privileged-setup n/a system installed

doctor exits 0 even when it reports errors, so read the findings and the final counts rather than the status. aide setup without --check installs what is missing and can be repeated. The troubleshooting page separates setup, DNS, TLS and routing failures.

Update

Check for a newer release, then confirm what runs.

aide update checks the MAIT update service with your credentials and stages a verified download. It asks for confirmation, so it needs a terminal. The next aide command you run (except aide legal), including aide version, switches to the downloaded release before it runs, so aide version then reports the newer release; if aide cannot switch, it prints a warning and runs your command with the installed release (see the update entry in Troubleshooting). You can also install a newer release through aidc install mait:aide@latest.

Print the installed version
# example output
$ aide version
aide 0.7.4

aide legal prints the copyright and the third-party components built into the binary; --full, --json and --markdown change the form.

Remove

Suspend a cluster, delete it, or remove aide.

CommandWhat it doesKeep in mind
aide cluster stopSuspends the cluster and keeps its stateaide cluster start resumes it and reapplies DNS and trust
aide cluster deleteDeletes the cluster and attempts DNS, trust and network cleanup--purge also removes the named volumes. Preserve data first
aide route reset <SERVICE>Clears overrides and routing annotationsUse it when a partial switch leaves a Service pointing at the wrong place

Delete each cluster from its project directory, or pass --project-file, and then check that its name no longer resolves and its aide-<project>.crt trust entry (the file /usr/local/share/ca-certificates/aide-<project>.crt) is gone. To remove AIDE itself, remove the administrator helper that aide setup added (the steps are in the getting-started page), then remove the binary the way it was installed, for example aidc uninstall mait:aide@<version> with the exact version from aidc list mait. The getting started page lists every step.

Next

Where to go next.