Download Kodachi OS

Self-hosted mirror. Every release is GPG-signed. Always verify the SHA-256 checksum and signature before booting.

Free runs the full OS. Premium adds low-density managed nodes, commercial rights, and priority support ($99/yr). Dedicated adds isolated single-tenant infrastructure.

Choose your build

Desktop · XFCE

Kodachi Desktop (XFCE) ISO

linux-kodachi-xfce-9.0.1-amd64.iso

Download 4.63 GB

Version9.8.2 Build#174 · 9.0.1.174 Size4.63 GB Updated2026-06-26

SHA-256 b2793ef62881a74fb65040f817e2a7b208555ef4f5713986259bdcbc257a99b6

SHA-512

0dbda4559f1c91130cabcaa359a468718565726c9e4418723e42a5dfa28a497fd265e5a5736b8d8c0313f0e39cca8402841c33f1918a692dcfd8082f00af8e29

MD5 6fe08fef11c8836724f9ce88bb94fe65

Files & checksums

ISO	linux-kodachi-xfce-9.0.1-amd64.iso	4.63 GB
SHA-512	linux-kodachi-xfce-9.0.1-amd64.iso.sha512	165 B
SHA-256	linux-kodachi-xfce-9.0.1-amd64.iso.sha256	101 B
MD5	linux-kodachi-xfce-9.0.1-amd64.iso.md5	69 B
Signature	linux-kodachi-xfce-9.0.1-amd64.iso.sig	512 B
Sig info	linux-kodachi-xfce-9.0.1-amd64.iso.sig.info	321 B
Public key	public_key_v9.0.1.pem	800 B
Release manifest	linux-kodachi-xfce-9.0.1-amd64-release-manifest.txt	139 KB

Terminal / Server

Kodachi Terminal / Server ISO

linux-kodachi-terminal-9.0.1-amd64.iso

Download 2.55 GB

Version9.8.2 Build#179 · 9.0.1.179 Size2.55 GB Updated2026-06-27

SHA-256 c1140c7d9f75288b4aeb1f1cb6b961a291172f0deee2cbb8f6f71c5b9ebf0678

SHA-512

4628db6b8beecfa495f275f7fcde0801120a129092156b92f22444d05665515c53573329265fac57d34169ce96fe0d298b2ee01c5629139e257f60ebce8d7d20

MD5 e157f26e6ef7a5000278bff977616f2a

Files & checksums

ISO	linux-kodachi-terminal-9.0.1-amd64.iso	2.55 GB
SHA-512	linux-kodachi-terminal-9.0.1-amd64.iso.sha512	169 B
SHA-256	linux-kodachi-terminal-9.0.1-amd64.iso.sha256	105 B
MD5	linux-kodachi-terminal-9.0.1-amd64.iso.md5	73 B
Signature	linux-kodachi-terminal-9.0.1-amd64.iso.sig	512 B
Sig info	linux-kodachi-terminal-9.0.1-amd64.iso.sig.info	325 B
Public key	public_key_v9.0.1.pem	800 B
Release manifest	linux-kodachi-terminal-9.0.1-amd64-release-manifest.txt	104 KB

Install Kodachi Binaries

The signed Kodachi APT repository is the recommended install and update path for Debian, Ubuntu, and Kodachi. Choose your system below for the exact supported command.

ISO users: binaries already included

You do not need this pack if you installed the Kodachi Desktop or Terminal ISO. Both editions already ship with the binaries built in. You only need this pack to update the binaries when a newer binaries release is published but the Desktop or Terminal ISO has not been rebuilt yet.

Full suite Debian 13, Ubuntu 24.04, and Kodachi. Includes the native dashboard, core services, AI suite, desktop integration, and recommended privacy tools.

Core and AI only Debian 12 and Ubuntu 22.04. Install the command-line core and AI packages. The current dashboard requires glibc 2.39 and is not supported on these releases.

Portable binaries Fedora, Arch, and other modern x86_64 Linux systems. Use the portable installer and provide equivalent system dependencies with your package manager.

Choose your Linux release

Debian 13 / Ubuntu 24.04 full APT suite Debian 12 / Ubuntu 22.04 core + AI Fedora / Arch / other portable

1Add the signed Kodachi repository

curl -fsSL https://kodachi.cloud/repo/setup.sh | sudo sh

2Install the full suite

sudo apt update && sudo apt install kodachi

These releases can run the command-line core and AI suite. Do not install the kodachi metapackage or kodachi-dashboard because the current dashboard requires glibc 2.39.

1Add the signed Kodachi repository

curl -fsSL https://kodachi.cloud/repo/setup.sh | sudo sh

2Install core and AI

sudo apt update && sudo apt install kodachi-hooks-core kodachi-ai

The portable route installs the signed binaries under /opt/kodachi/dashboard/hooks. Its dependency helper is APT-oriented, so Fedora, Arch, and other distributions should install equivalent packages with their own package manager.

1Install the portable binaries

curl -sSL https://kodachi.cloud/apps/os/install/kodachi-binary-install.sh | bash

2Debian-family dependency helper, optional elsewhere

curl -sSL https://kodachi.cloud/apps/os/install/kodachi-deps-install.sh | sudo bash

APT package choices

Package	Purpose
`kodachi`	Full suite for Debian 13, Ubuntu 24.04, and Kodachi.
`kodachi-hooks-core`	Command-line VPN, Tor, DNS, authentication, integrity, and core services without the desktop app.
`kodachi-ai`	Local-first AI suite. APT pulls the shared core automatically.
`kodachi-dashboard`	Native desktop dashboard for systems with glibc 2.39 or newer.
`kodachi-conky`	On-screen status widget. APT pulls the shared core automatically.

Individual privacy tools are also available as standalone packages, including kodachi-xray, kodachi-hysteria, kodachi-mieru, kodachi-v2ray, kodachi-v2ray-plugin, kodachi-kloak, and kodachi-dnscrypt.

Update or remove an APT installation

Full suite:

sudo apt update && sudo apt upgrade

sudo apt remove kodachi    # remove only the metapackage
sudo apt purge kodachi     # purge only the metapackage configuration
sudo apt autoremove --purge # review APT's list before confirming

The component packages installed as dependencies remain after removing or purging only the kodachi metapackage. Run apt autoremove --purge only after reviewing APT's proposed list, because it removes every automatically installed package that APT now considers unused.

Core and AI:

sudo apt update && sudo apt install --only-upgrade kodachi-hooks-core kodachi-ai

sudo apt remove kodachi-hooks-core kodachi-ai
sudo apt purge kodachi-hooks-core kodachi-ai
sudo apt autoremove --purge # review APT's list before confirming

Compatibility and package details Verify downloads and signatures Installation troubleshooting

Optional: manual / offline tarball (advanced)

For air-gapped or offline setups only. The terminal install above is the recommended method for all standard installations.

Binaries Tarball

Kodachi Binaries Pack (online installer)

kodachi-binaries-v9.0.1.tar.gz

Download 254.56 MB

Version9.8.2 Build#316 · 9.0.1.316 Size254.56 MB Updated2026-06-26

SHA-256 f7b3677c59cdb5ecf80954b0614420cd697bf4c669339e8d808f502dad323dd0

Files & checksums

Tarball	kodachi-binaries-v9.0.1.tar.gz	254.56 MB
SHA-256	kodachi-binaries-v9.0.1.tar.gz.sha256	97 B
Signature	kodachi-binaries-v9.0.1.tar.gz.sig	512 B
Sig info	kodachi-binaries-v9.0.1.tar.gz.sig.info	362 B
Public key	public_key_v9.0.1.pem	800 B

Debug Collector

If you encounter issues with your Kodachi installation, the Debug Collector gathers system diagnostics into a single zip file you can share with the support team. It collects boot logs, hardware specs, network configuration, Kodachi service status, and more.

Privacy First

The collector does not capture browsing data or personal files. Passwords, passphrases, API keys, private keys, authentication headers and VPN credentials are stripped before anything is written to the archive, and again in a final pass over the whole bundle. That includes the WireGuard and AmneziaWG keys that identify which server you connect to, not only the ones that would let someone connect as you. WiFi network names (SSIDs) and MAC addresses are replaced with placeholders. Public IP addresses, both IPv4 and IPv6, are redacted; private LAN, loopback and link-local addresses are kept, because a network problem cannot be diagnosed without them. You can also deselect specific categories before collection starts.

Run the debug collector (interactive category menu):

curl -sSL https://kodachi.cloud/apps/os/install/kodachi-debug-collector.sh | sudo bash

Skip the menu and collect everything:

curl -sSL https://kodachi.cloud/apps/os/install/kodachi-debug-collector.sh | sudo bash -s -- --all

Verify your download

After downloading, confirm the SHA-256 matches the value shown above:

sha256sum linux-kodachi-xfce-9.0.1-amd64.iso
# compare the output against the SHA-256 listed on this page

To verify the GPG signature, import the public key shipped beside each ISO and run openssl dgst -sha256 -verify public_key_v9.0.1.pem -signature FILE.iso.sig FILE.iso.

Open online verification tool →

Download Kodachi OS

Choose your build

Kodachi Desktop (XFCE) ISO

Kodachi Terminal / Server ISO

Install Kodachi Binaries

APT package choices

Update or remove an APT installation

Optional: manual / offline tarball (advanced)

Kodachi Binaries Pack (online installer)

Debug Collector

Privacy First

Download trends

By operating system

By country

Downloads by country

Verify your download