# CMai OS Documentation

> The official documentation for CMai OS Server Edition, from installation through to updates. One page (https://docs.cmaios.com/en/), with every section reachable by anchor. Full text as Markdown: https://docs.cmaios.com/en/llms-full.txt · Turkish version: https://docs.cmaios.com/

## Sections

- [Getting started](https://docs.cmaios.com/en/#baslarken): four steps — install, wizard, SSH, publish
- [Requirements](https://docs.cmaios.com/en/#gereksinimler): 8 vCPU / 32 GB / 500 GB NVMe recommended; 2 vCPU / 4 GB / 40 GB for a trial; amd64 only; BIOS or UEFI; outbound access to license.cmaios.net
- [Downloading and verifying the ISO](https://docs.cmaios.com/en/#iso): releases.cmaios.net, sha256sum / certutil
- [VirtualBox / bare-metal installation](https://docs.cmaios.com/en/#kurulum): unattended, takes the whole disk; bridged networking; Secure Boot off
- [First boot and the wizard](https://docs.cmaios.com/en/#ilk-acilis): the console card, https://<ip>:8443, the one-time setup code, the licence key, the admin account (SSH key or password)
- [Connecting](https://docs.cmaios.com/en/#baglanma): ssh <admin>@<ip> lands straight in the workspace; host commands as `ssh … "sudo cmai …"`
- [The CMai API and the AI tools](https://docs.cmaios.com/en/#cmai-api): one key for every model, CMai CLI, the workspace environment variables, Claude Code · Gemini CLI · Kimi CLI with your own account
- [CLI reference](https://docs.cmaios.com/en/#cli): cmai license status|activate|renew|deactivate, cmai user add|start|stop|rm|shell, cmai update check|apply|channel, cmai doctor, cmai banner, cmai setup code
- [Licensing](https://docs.cmaios.com/en/#lisans): activation, online verification, lock mode (no data is deleted), unlocking, moving servers
- [Admin panel](https://docs.cmaios.com/en/#panel): https://<ip>:8443 — licence status, device id, renew, change key
- [Security](https://docs.cmaios.com/en/#guvenlik): Ed25519-signed licences and updates, TLS 1.2+/1.3, key-based SSH (password login switches off automatically), default-deny nftables firewall, fail2ban, isolated rootless workspaces
- [Troubleshooting](https://docs.cmaios.com/en/#sorun): Permission denied (publickey), "Your workspace is being prepared", the console card shows no IP, the system is locked
- [Releases and updates](https://docs.cmaios.com/en/#surumler): 0.1.0-dev.<n>+<sha>; cmai update; channels stable/beta/nightly
- [FAQ](https://docs.cmaios.com/en/#sss) and [Glossary](https://docs.cmaios.com/en/#sozluk)

## Elsewhere

- [Product site](https://cmaios.com/en/) · [ISO releases](https://releases.cmaios.net/en/) · [Customer portal](https://portal.cmaios.com/)
- Contact: isgelistirme.ortaklik@cmapps.com.tr