Troubleshooting & FAQ
A workbench won't open
"this workbench profile has no published image" (macOS) No workbench images are published to the downloads site yet, so a release build has nothing to clone the VM from. The full message lists the reasons, for example that the profile matches no published preset and that developer mode is off. See Workbench images.
The Tart sheet appears, or "tart not found" (macOS)
Kenaz needs Tart to run workbenches. Click Install on the sheet, or run
brew install tart and click I already installed it — re-check. See
Tart. If the install fails, the sheet
says why, for example Verification failed (the download didn't match the
expected checksum, so nothing was installed) or Download stalled.
"code-server not found on PATH" (Linux)
Workbenches on Linux run code-server on your computer. Install it, make
sure it's on the PATH Kenaz sees, and open the workbench again. See
Linux hosts.
"Not enough host resources" The workbenches you have running already use the host budget. Stop one from the dialog, lower the profile's CPUs or memory, or raise the budget with Adjust budget…, then click Retry. See Resources.
A message that the profile asks for more than one workbench may claim One workbench can use at most all CPUs but two, 75% of memory and half of the disk's total size (not how full it is). Lower the profile's resources.
"edit the profile (Size to fit)" The profile gives its apps less CPU or memory than they need. Open the profile and click Size to fit.
"not enough disk to open this workbench" The message says how much space is needed and how much is free. Use Reclaim disk… in the Workbenches list to remove VMs, images or workbench folders you no longer need. See Freeing disk space.
Something else Click Diagnostics on the workbench's row, or Show log, to see its startup log.
Inside a workbench
A tool can't reach the network, or shows "N blocked" in the top bar The workbench's firewall blocked the connection. Open Egress, find the destination under Recently blocked, click Allow host, then restart the workbench. See Network access.
The Harness has no provider The profile's AI provider was set to Defer, or the key couldn't be read from the keychain. Set the provider in the profile and restart the workbench. Also check that the provider's API host is allowed.
My files are gone after I stopped the workbench Stopping a workbench deletes its VM. Only files in the workspace directory and other read-write shared folders are kept. See Stopping, and what's kept.
I closed the window, but the workbench is still using memory Closing the window suspends the workbench; the VM keeps running. Click Stop to shut it down.
The app
Kenaz didn't open a second window when I launched it again Only one copy of Kenaz runs at a time. A second launch hands over to the running copy.
Where are the logs?
| What | macOS | Linux |
|---|---|---|
| Kenaz's log | ~/Library/Logs/Kenaz/kenaz.log (also in Console.app) | ~/.local/state/kenaz/kenaz.log (or $XDG_STATE_HOME/kenaz/kenaz.log) |
| A workbench's startup log | Show log on its row in the Workbenches list | same |
Kenaz's log is JSON lines. It is capped at 10 MiB, with two older files kept.
Set KENAZ_LOG_FILE=<path> to move it, or KENAZ_LOG_FILE=off to turn the
file off.
Where does Kenaz keep its data?
| What | Where |
|---|---|
| Profiles | ~/.kenaz/profiles |
| Workbench records and folders | ~/.kenaz/workbenches |
| Workbench images (macOS) | ~/.kenaz/workbench/images |
| Tart installed by Kenaz (macOS) | ~/.kenaz/tart.app, ~/.kenaz/bin/tart |
| Tart VMs (macOS) | ~/.tart/vms |
| Window and app settings | ~/Library/Application Support/kenaz/settings.json (macOS), ~/.config/kenaz/settings.json (Linux) |
| Provider keys and sign-in tokens | Your operating system's keychain |
FAQ
Do I need a Kameas account? No. Click Skip for now on the first screen. You can sign in later from Settings → Account.
Is there a Windows or Intel Mac version? No. Builds are published for macOS on Apple Silicon and Linux on amd64 and arm64. See Install and update.
How do I update? Download the new release and install it over the old one. Kenaz doesn't update itself. See Updating.
Can I use the Harness without Kenaz? Yes. The Kenaz Harness is a separate download that runs on its own.
Still stuck?
For private or security questions, email security@kameas.ai.