Skip to content

Linux Kodachi — Overview

Linux Kodachi

Linux Kodachi is a privacy-focused Debian-based distribution with hardened defaults and an integrated anonymity stack (failover VPN, Tor routing, DNS protection, and anti-forensics utilities) that most operating systems leave users to assemble and harden manually.

Kodachi 9.0.1 introduces KAICS (Kodachi AI Command Intelligence System) plus ai-gateway, forming an intelligent, self-improving security platform: control services in plain English with ai-cmd, manage and validate models with ai-trainer, improve accuracy through feedback with ai-learner, automate monitoring with ai-monitor/ai-scheduler, and enforce machine-safe execution through ai-gateway. kodachi-claw provides an anonymous autonomous AI agent runtime with embedded Tor circuits, identity randomization, and OPSEC filtering. KAICS is offline-first, using tiered local intelligence (TF-IDF → ONNX semantic → Mistral.rs GGUF → GenAI/Ollama) with optional cloud inference routable through VPN or Tor only when explicitly selected (Claude CLI).

New users: start with the Quick Start, then review the AI Command Guide and the Binaries Overview.

Anti-Forensic Anonymous Secure AI-Powered User-Friendly

Kodachi Desktop Edition — Released

Kodachi Desktop brings full Kodachi security to a permanent installation. A privacy-hardened Debian XFCE distribution with offline installation, bundled Secure Boot support, and the complete Kodachi anonymity stack pre-configured from first boot. No network required during setup — no IP prompts, no DHCP delays, no fingerprinting window. VPN failover, Tor routing, DNS protection, anti-forensics, and all 20 Rust security services ready out of the box. Get Kodachi Desktop →

Introducing Kodachi Claw — Anonymous AI Agent Runtime

kodachi-claw is here. Forged from ZeroClaw's ultra-lightweight Rust agent engine, it hides your AI agent inside the Tor network. Every API call, every model request, every channel message routes through embedded Tor circuits with identity randomization and OPSEC filtering. Connect to 28+ AI providers, listen on 15+ channels (Telegram, Discord, Slack, Matrix, Signal, and more), execute tools, manage memory, and run scheduled tasks — all from a single binary that cannot be tracked, fingerprinted, or traced. Explore Kodachi Claw →

New: Kodachi AI Command Intelligence — Ask Anything in Plain English

KAICS + ai-gateway transform Kodachi into an intelligent security platform. AI tooling with NLP-driven command processing, proactive security automation, offline-first tiered intelligence, and policy-enforced agent execution. kodachi-claw adds an anonymous AI agent runtime where every request routes through embedded Tor circuits with identity randomization. Just describe what you want — Kodachi handles safe orchestration.

ai-cmd — live examples
Everyday Essentials
$ ai-cmd query "what is my ip?"Copy
→ ip-fetch fetch
$ ai-cmd query "am i on tor?"Copy
→ tor-switch check-tor
$ ai-cmd query "am i leaking my ip?"Copy
→ dns-leak test --check-ip
Privacy & Security
$ ai-cmd query "is my dns encrypted?"Copy
→ dns-switch dnscrypt-status
$ ai-cmd query "what is my security score?"Copy
→ health-control security-score
$ ai-cmd query "generate me a password"Copy
→ health-control genpass
Network & System
$ ai-cmd query "what is eating cpu?"Copy
→ health-control offline-info-process
$ ai-cmd query "show me all ips connected to my pc"Copy
→ ss -tnp state established
Advanced
$ ai-cmd query "is digi77.com ssl valid?"Copy
→ openssl s_client -connect digi77.com:443 | openssl x509 -noout -dates
$ ai-cmd query "change all mac addresses"Copy
→ sudo health-control mac-change-all
$ ai-cmd query "what is the ssl fingerprint of google.com"Copy
→ openssl s_client -connect google.com:443 | openssl x509 -fingerprint -sha256 -noout
$ ai-cmd query "all hash values of ~/Desktop/test.zip"Copy
→ md5sum, sha1sum, sha256sum, sha512sum ~/Desktop/test.zip

12 examples shown — KAICS understands thousands of natural language queries across security, networking, privacy, and system operations. Get Started with the AI Command Guide →
Kodachi Dashboard: All of the above can also be run from the GUI — the Dashboard provides the same AI-powered functionality with point-and-click simplicity, no terminal required.


The Kodachi Story

The Complete Kodachi Journey (2005-2025)

The Beginning (2005-2013)

Beginning in 2005, my journey with Linux started on the desktop, built on a solid background in server management. Initially drawn to the flexibility of Linux Mint, I realized many of its most powerful features were hidden behind graphical interfaces. That discovery led me back to Windows for a period, but my passion for Linux never faded. By late 2012, I set out to create a secure, user-friendly alternative, starting with Linux Mint before transitioning to Ubuntu for its driver support and broader hardware compatibility. On 20 October 2013, the first version of Kodachi OS was released, marking the start of a development journey that has now spanned nearly 12 years.

The Vision & Design (2013-2015)

My vision was clear: build an operating system that empowers everyday users with robust privacy and security without requiring deep technical expertise. Kodachi was designed as a secure daily driver, integrating a built-in VPN, DNS control scripts, Tor integration, encrypted crypto wallets, full-disk encryption utilities, and a custom browser with advanced security features. The result is an environment where powerful protection is accessible to anyone, not just experts.

Community Growth & Recognition (2015-2020)

Encouraged by its potential, I shared Kodachi with the wider community. Over the years there were moments when I stepped away from development, yet the unwavering support of its users continually pulled me back. Today, Kodachi stands among the top security-focused Linux systems, widely recognized for its intuitive dashboard, elegant interface, and role in making Linux security approachable for thousands of users. With an average of 7,000 downloads per month and peaks up to 10,000, as verified by SourceForge download statistics, Kodachi has earned a trusted place in the cybersecurity landscape.

Transformation & Impact (2020-2023)

Kodachi is more than software; it has been a transformative journey for both myself and its community. Users consistently share how it changed their approach to digital privacy, shifting them from passive observers to proactive guardians of their security. For many, Kodachi has been the bridge that opened their eyes to the true potential of Linux.

Commitment & Dedication (2023-Present)

Even as a one-person project, Kodachi continues to grow through relentless dedication and the inspiration drawn from its community. I prioritize security and stability above all else, addressing vulnerabilities swiftly and releasing timely patches, often in rapid succession, to ensure reliability. This hands-on response reflects my deep commitment to protecting users.

The Future Mission (2025 & Beyond)

Kodachi represents the rare balance of advanced protection with true ease of use. Every release strengthens this foundation, ensuring users can rely on it to safeguard their digital lives. Looking ahead, my mission remains the same: to evolve Kodachi as a trusted, cutting-edge platform where privacy and security are not optional, but built-in for everyone.

Global Reach & Community Trust

From its first release in 2013, Kodachi has grown into a globally trusted privacy platform, serving users across 224 countries with consistent growth year after year. These numbers reflect not just downloads, but a worldwide community committed to digital privacy and security.

892956

Total Downloads

Since October 2013

224

Countries Worldwide

Across all continents

6,024

Average Monthly

Over 12 years of growth

12

12

Years of Trust

Continuous development

Global Geographic Distribution

Downloads Across 6 Continents

45.9%

🌍 Europe

409,605

26.5%

🌎 North America

236,514

12.8%

🌏 Asia

113,996

4.9%

🌎 South America

43,840

3.8%

🌍 Africa

34,001

2.4%

🌏 Oceania

21,009

Top 6 Countries by Downloads

22.17%

🇺🇸 USA

197998

10.85%

🇷🇺 Russia

96913

5.29%

🇩🇪 Germany

47200

3.41%

🇬🇧 UK

30425

3.33%

🇨🇦 Canada

29745

3.16%

🇫🇷 France

28262

Operating Systems Distribution

61.5%

⊞ Windows

529,955

27.7%

🐧 Linux

238,976

4.1%

🍎 macOS

35,612

2.0%

🤖 Android

17,586

0.04%

😈 BSD

352

<0.01%

☀️ Solaris

37

💡 Platform Insights
Strong Linux Community
27.9% Linux adoption vs ~3% global desktop share — demonstrating a highly technical, privacy-conscious user base.
True Multi-Platform
Available on 6 platforms (Windows, Linux, macOS, Android, BSD, Solaris) — maximizing accessibility across all ecosystems.
Desktop-First Privacy
93.4% desktop users (Win/Linux/Mac/BSD/Solaris) vs 2.1% mobile — reflecting that serious privacy work requires full desktop capabilities.
Windows to Linux ratio: 2.2 : 1 (547,036 Windows vs 249,322 Linux downloads)

Top 5 Countries by Downloads

United States

22.17%

Russia

10.85%

Germany

5.29%

United Kingdom

3.41%

Canada

3.33%

Netherlands

3.16%

Interactive Global Distribution Map

Data source: SourceForge API Download JSON Last updated: February 26, 2026

These numbers represent more than downloads — they reflect a global movement of individuals taking control of their digital privacy. From students and journalists to security professionals and privacy advocates, Kodachi has become a trusted companion in the journey toward digital sovereignty. Every download is a statement: privacy matters.

Kodachi is built and maintained by one person since 2013. If this project protects your privacy, consider a small donation to keep the servers and development going.
Support Kodachi

Kodachi 9: Development & Architecture

A transformative journey from legacy constraints to universal freedom

Legacy Kodachi — Superseded

Kodachi 8.x has officially reached its end of life. While it served our community faithfully, its architecture was confined to the original Kodachi environment, limiting user choice and flexibility.

Development Timeline

August 2024: Kodachi 9 development officially began
September 2025: Multiple major milestones achieved
Development: 18 months of intensive development and architectural transformation
February 2026: Kodachi Desktop XFCE released — full desktop with 440+ packages
GitHub: Track development progress →

Kodachi 9 Dashboard with AI Capabilities

IN PROGRESS

The Kodachi 9 dashboard now features integrated AI capabilities powered by KAICS and ai-gateway — natural language command execution, intelligent security monitoring, proactive system analysis, and policy-enforced agent execution. The gateway layer provides machine-readable command invocation, JSON argument input, dangerous-command confirmation controls, and trusted-agent capability profiles (zeroclaw, nullclaw, openclaw, picoclaw, nanoclaw, kodachi-claw, claude-code, gpt, gemini, open-interpreter). kodachi-claw extends this with an anonymous autonomous AI agent runtime — embedded Tor circuits, identity randomization, and OPSEC filtering for invisible AI operations. This preview showcases the AI-powered dashboard in action alongside real-time system health, centralized logs, and the IP geolocation map.

Platform Independence

Legacy Limitation: All previous Kodachi versions were confined to their original environment, forcing users into a single platform choice.

New Architecture: Kodachi 9's modular design breaks these barriers, enabling deployment across any Debian-based Linux distribution.

User Empowerment: Choose your platform - use the binaries on your preferred Linux distribution, deploy the command-line server, or wait for the complete desktop experience. The choice is now truly yours.

Linux Kodachi Architecture

Kodachi System: Security and Privacy Lifecycle Workflow

Complete security lifecycle from boot verification through secure termination

Phase 1: Server Development COMPLETED

Phase 3: Anonymity Verifier

Website

COMPLETED

External Verification Service

Master VPS Node

Authentication Gateway

Phase 1: COMPLETED
  • User Authentication
  • Documentation Access
  • VPS Node Assignment
  • Initial Access Control

Phase 4: Knowledge Base

Website

COMPLETED

External Documentation & User Resources

Connection Flow

STEP 1: Authentication via Master Node
STEP 2: Direct Connection to VPS
Phase 2: VPS Nodes Network COMPLETED

After authentication, users connect DIRECTLY to assigned VPS nodes

Free VPS Nodes

  • Shared VPS
  • High Load
  • Many Users Per Server

FREE TIER USERS

Premium VPS Nodes

  • Limited Users/Node
  • Balanced Performance
  • Better Speed

PREMIUM TIER USERS

Enterprise Nodes

  • Dedicated Servers
  • Custom Architecture
  • Maximum Performance

ENTERPRISE USERS

Client Connection

Clients connect through VPS Nodes
Via Master Node Authentication
Phase 3: Client Deployments IN PROGRESS

VPS Infrastructure & Master Node

All deployments connect here for authentication, updates, and security services

↑ ↑ ↑

Kodachi Binaries / Backend Services

v9.0.1 Build #86
Released: 03 October 2025
Updated: 26 February 2026

Components:

  • 13 Rust Binaries
  • Service Layer
  • Security Core

Foundation: Rust Optimized Core Components

Purpose: Foundation for all deployments

Availability: Also available standalone for Linux distros

Phase 5: COMPLETED

Frontend Desktop App

GUI Components

System Controls

v9.0.1 Build #86
Released: 03 October 2025
Updated: 26 February 2026
Phase 7: COMPLETED

Kodachi Desktop

Debian + XFCE Desktop

Full OS with GUI

v9.0.1 Build #1
Released: 26 February 2026
Updated: 20 February 2026
Phase 8: COMPLETED

Kodachi Terminal Server

Terminal-Only Live ISO

Testing & SOCKS Proxy Gateway

v9.0.1 Build #27
Released: 30 October 2025
Updated: 26 February 2026
Phase 6: COMPLETED

Support Kodachi's Mission

View our pricing plans, donation options, and learn how your support keeps Kodachi free for personal use while ensuring long-term sustainability.

View Support & Pricing

Kodachi Desktop Edition — Released

Now Available: Kodachi Desktop XFCE

A full XFCE desktop based on Debian 13 (Trixie), designed for daily privacy-focused computing with a complete GUI application suite. Ships with all 22 Kodachi binaries, the Tauri Dashboard, Conky system monitor, and 10 dynamic application layers.

ISO Size
~5GB (full desktop)
Total Packages
440+ packages
Pre-Installed Binaries
All 22 binaries
Dynamic Layers
10 optional layers

For complete documentation, installation guides, and layer details:

View Desktop Documentation

Kodachi Terminal Server Edition — Production Ready

Now Available: Terminal Server Live ISO

A minimal, terminal-only live ISO based on Debian 13 (Trixie) designed for two critical missions: bulletproof testing of the full Kodachi toolchain and operating as a dedicated SOCKS proxy gateway for your network. Built for power users, hardened servers, and elegant headless deployments.

ISO Size
2.4GB (lightweight)
Total Packages
1,181 packages
Pre-Installed Binaries
All 21 core binaries
Routing Protocols
12+ protocols supported

For complete documentation, installation guides, and workflow examples:

View Terminal Server Documentation

Key Use Cases

Binary Testing Environment: Safe, isolated environment to test all 22 Kodachi binaries in VMware, VirtualBox, or bare metal without affecting your main system.

Network-Wide SOCKS Proxy: Run as a dedicated proxy gateway on old hardware or VM to anonymize your entire network through a single centralized point.

Privacy-First Operations: 92+ pre-configured security workflows, 12+ routing protocols (OpenVPN, WireGuard, Tor, Shadowsocks, V2Ray, Xray, Hysteria2), and comprehensive anonymity configurations.

AI-Powered Intelligence: KAICS plus ai-gateway — 6-tier AI engine (TF-IDF → ONNX → Mistral.rs → GenAI/Ollama → Legacy LLM → Claude CLI), natural language command interface with real-time streaming and native tool calling, proactive monitoring, automated scheduling, and policy-enforced machine execution for trusted agents. kodachi-claw adds an anonymous autonomous AI agent runtime with embedded Tor circuits, identity randomization, and OPSEC filtering — every AI request invisible on the network. All core AI processing happens locally — optional cloud AI tiers can be routed through VPN or Tor.


Security & Privacy Linux Operating Systems — Feature Comparison

This comparison highlights key capabilities across major privacy OS platforms.

Note: This comparison was generated by GPT and Claude AI.


Global Recognition & Awards

6-Year Consecutive #1 Privacy OS - TechRadar

Year Recognition Certificate
2025 #1 Privacy & Security Linux Distribution by TechRadar View PDF
2024 #1 Privacy & Security Linux Distribution by TechRadar View PDF
2023 #1 Privacy & Security Linux Distribution by TechRadar View PDF
2022 #1 Privacy & Security Linux Distribution by TechRadar View PDF
2021 #1 Privacy & Security Linux Distribution by TechRadar View PDF
2020 #1 Privacy & Security Linux Distribution by TechRadar View PDF

Major Media Recognition

ZDNet 2025

Featured as one of the "5 best Linux distros for staying anonymous when a VPN isn't enough"

Linux Format UK

Named "Top Privacy Distribution" by Linux Format World UK Magazine (2020)

APC Magazine

Awarded "Lab Hot Product" designation by Australian APC Magazine (August 2021)

Global Presence

🛡️

Wikipedia Recognition

Official documentation across multiple languages

Global Reach: Official recognition across 3 major Wikipedia editions, serving millions of readers worldwide

Professional Reviews & Analysis

Professional Reviews & Media Coverage

Publication Article Title / Description Link
TechRepublic Kodachi: The OS for those who value privacy but don't want to learn Linux Read
MakeUseOf Linux Kodachi Privacy-Focused Distro Overview Read
MakeUseOf Tails vs Linux Kodachi - Comprehensive Comparison Read
MakeUseOf Best Linux Distros for Privacy & Security Read
MakeUseOf MakeUseOf 2022 Review PDF
LinuxInsider In-depth review of Kodachi's security features Read
LinuxHint Best OS for security and privacy - comprehensive analysis View PDF
HostZealot Top 5 privacy-focused Linux distributions Read
PrivateInternetAccess Privacy distribution analysis and comparison Read
Russian Losst - Complete Kodachi Linux installation guide Read
Arabic 2linux.org - Comprehensive review Read
Arabic UpdateLap - Kodachi features review Read
Arabic WikiKali - Version 6.0 Review Read
Arabic Itigic - Security and Anonymity Focus Read
LinuxNewbieSince Kodachi 7.0 - The Secure OS Review Read
TheDigestOnline Top 7 Most Secure Linux Distros for Privacy in 2025 Read
DistroWatch 2019 - First place in privacy category View Tweet

Learn Through Video


Release history

Kodachi has been continuously updated since October 20, 2013. With 50+ releases spanning 11 years, each version brings enhanced security, new features, and improved performance. View the complete release timeline for all versions.


Legal Notice and Terms of Use

By using Linux Kodachi, you acknowledge and agree that its primary purpose is to protect legitimate privacy rights and ensure secure online activities.

IMPORTANT LEGAL REQUIREMENTS:

• Kodachi must NOT be used for illegal activities or criminal purposes

• Users are solely responsible for compliance with all applicable laws in their jurisdiction

• The developers disclaim all liability for misuse or illegal use of this software

• This software is provided for legitimate privacy protection, security research, and educational purposes only

If you intend to use this software for unlawful purposes, you must discontinue use immediately.