Install and update Kenaz
Download Kenaz from the download page. The Kenaz section there always lists the latest release.
What's published
| Platform | Files |
|---|---|
| macOS, Apple Silicon (arm64) | kenaz-<version>-darwin-arm64.dmg (installer) and kenaz-<version>-darwin-arm64.zip (the app bundle) |
| Linux, x86-64 (amd64) | kenaz-<version>-linux-amd64.AppImage and kenaz-<version>-linux-amd64.tar.gz |
| Linux, arm64 | kenaz-<version>-linux-arm64.tar.gz |
There are no Windows or Intel Mac builds. The download page shows SHA-256 checksums for each release.
macOS
You need macOS 13 (Ventura) or later on Apple Silicon.
- Download the
.dmgand open it. - Drag the Kenaz app onto the Applications folder shown in the window.
- Open Kenaz from Applications.
Release builds are signed with a Developer ID and notarized by Apple, so Gatekeeper opens them without extra steps.
To run workbenches, Kenaz also needs Tart. You don't have to install it first: Kenaz offers to install it the first time you open a workbench. Tart has its own licence; see Tart's licence.
Linux
Kenaz targets Ubuntu 24.04 or later, on Wayland or X11. It is built against GTK 3 and WebKitGTK 4.1, so your system needs those runtime libraries.
AppImage (amd64):
chmod +x kenaz-*-linux-amd64.AppImage
./kenaz-*-linux-amd64.AppImage
Tarball (amd64 or arm64). The archive has no top-level folder, so extract it into one:
mkdir kenaz && tar -xzf kenaz-*-linux-*.tar.gz -C kenaz
cd kenaz
./kenaz
The tarball also contains kenaz.desktop and kenaz.png if you want a
menu entry:
mkdir -p ~/.local/bin ~/.local/share/applications ~/.local/share/icons/hicolor/1024x1024/apps
install -m 0755 kenaz ~/.local/bin/
install -m 0644 kenaz.desktop ~/.local/share/applications/
install -m 0644 kenaz.png ~/.local/share/icons/hicolor/1024x1024/apps/
Keep the kameas-ml folder next to the kenaz program; Kenaz looks for it
there.
Workbenches on Linux need code-server installed. See
Linux hosts.
Updating
Kenaz doesn't install updates itself. Releases that include the update check
look at the release list on downloads.kameas.ai at most once a day and tell
you when a newer version is out (Help → Check for Updates… asks right
away; the Check for updates automatically setting turns the daily check
off). The check sends no account, device or usage information. Earlier releases
don't check at all. To update:
- Quit Kenaz.
- Download the new release from the download page.
- Install it the same way, replacing the old copy.
Your profiles, workbench records and settings live outside the app (mostly
under ~/.kenaz), so replacing the app keeps them.
On macOS, quitting Kenaz leaves running workbench VMs running. The next launch picks them up again. Stop your workbenches first if you want a clean start after the update.
Only one copy runs at a time
If you launch Kenaz while it's already running, the new launch hands over to the running copy and exits. If the previous copy is still quitting, the new one waits up to 10 seconds for it.