v....

Introduction

Everything you need to know to get up and running quickly.

Tip: you can toggle between light and dark mode using the button in the top-right corner.

Installation

Watch this installation video after you download the .iso bootable file.

Zyphor CLI

Installation: zyphor pkg install zyphor-cli

Note: Zyphor CLI is pre-installed and available by default after operating system installation.

Zyphor CLI Abstraction Layer — A unified command framework that transforms complex Linux operations into simple, consistent, and easy-to-remember commands for developers, administrators, and everyday users.

zyphor help

Category	Command	Description
SYSTEM	`zyphor system upgrade`	Upgrade all installed system packages to their latest available versions from configured repositories, ensuring security updates, bug fixes, and feature improvements are applied.
SYSTEM	`zyphor system clean`	Remove package caches, temporary files, and unused dependencies to free disk space and keep the system optimized.
SYSTEM	`zyphor system info`	Display detailed information about the operating system, kernel version, hardware resources, and system environment.
SETUP	`zyphor setup dev <target>`	Automatically configure a complete development environment for the selected programming language or technology stack.
SETUP	`zyphor setup dev php`	Install and configure PHP, Composer, Node.js, and other tools commonly required for modern PHP application development.
SETUP	`zyphor setup dev node`	Install Node.js runtime and package management tools for building JavaScript and TypeScript applications.
SETUP	`zyphor setup dev composer`	Install Composer and configure the environment for managing PHP packages and project dependencies.
SETUP	`zyphor setup dev git`	Generate SSH keys, configure Git settings, and prepare secure authentication for GitHub and Git-based workflows.
SETUP	`zyphor setup theme light`	Apply the Windows-10 inspired desktop theme for a bright and familiar user experience.
SETUP	`zyphor setup theme dark`	Apply the Kali-Dark inspired desktop theme optimized for developers and low-light environments.
PACKAGE	`zyphor pkg install <pkg>`	Install software packages from configured repositories while automatically resolving required dependencies.
PACKAGE	`zyphor pkg remove <pkg>`	Uninstall a package and optionally remove associated dependencies that are no longer required.
PACKAGE	`zyphor pkg search <key>`	Search available repositories for packages matching a keyword, name, or partial package identifier.
PACKAGE	`zyphor pkg list`	Display all currently installed packages along with their versions and installation status.
SERVICE	`zyphor service restart <name>`	Restart a running service to apply configuration changes or recover from operational issues.
NETWORK / STORAGE	`zyphor smb mount`	Connect and mount a remote SMB/CIFS network share, making it accessible like a local directory.
FTP	`zyphor ftp upload`	Transfer files securely from the local system to a configured FTP server.
SSH	`zyphor ssh connect`	Establish a secure encrypted shell session to a remote server for administration and maintenance.
SSH	`zyphor ssh cmd`	Execute commands on a remote server over SSH without opening an interactive terminal session.
DOCTOR	`zyphor doctor scan`	Analyze the system for configuration issues, missing dependencies, broken packages, and common problems.
DOCTOR	`zyphor doctor fix`	Attempt to automatically repair issues detected during a diagnostic scan.
DOCTOR	`zyphor doctor report`	Generate a comprehensive diagnostic report for troubleshooting and technical support purposes.
BUILD	`zyphor build package [dir]`	Build a Debian package from a project directory, simplifying software packaging and distribution.
BUILD	`zyphor build repo`	Generate repository metadata files such as Packages.gz for hosting a Debian-compatible package repository.
CORE	`zyphor help`	Display the complete Zyphor CLI command reference, categories, usage examples, and available options.

Zyphor Command Center

Installation: zyphor pkg install zyphor-comand-center

Note: Zyphor Command Center is pre-installed and available by default after operating system installation.

Zyphor Command Center — A graphical management interface built on top of Zyphor CLI, providing an intuitive point-and-click experience for non-technical users. Perform system updates, install software, manage services, configure development environments, mount network shares, run diagnostics, and customize system settings without memorizing terminal commands.

ZyLearn

Installation: zyphor pkg install zylearn

Note: ZyLearn is NOT pre-installed and available by default after operating system installation.

ZyLearn is an interactive learning tool designed to teach Linux distribution development through practical, real-world experience. Rather than relying solely on documentation or videos, ZyLearn provides a working project that users can explore, modify, and build themselves.

When launched, ZyLearn automatically clones the zyphor-os-minimal project into the current directory and includes a comprehensive GUIDE.md file containing step-by-step instructions for Linux operating system development.

ZyLearn serves as a hands-on educational environment for students, Linux enthusiasts, and aspiring distribution maintainers who want to understand how modern Linux distributions are built from the ground up.

Available Commands

Command	Description
`zylearn setup skeleton`	Install the Zyphor OS learning skeleton environment in the current directory. This command downloads and prepares the `zyphor-os-minimal` project, including the `GUIDE.md` documentation that walks learners through Linux distribution development step by step.
`zylearn show logs`	Display recorded learning activity logs, including completed lessons, executed learning tasks, and progress information generated by ZyLearn.
`zylearn clear logs`	Remove all stored learning activity logs and reset ZyLearn progress history for a fresh learning experience.
`zylearn --help`	Display command usage information, available commands, options, and examples for the ZyLearn learning environment.
`zylearn --version`	Show the installed ZyLearn version and release information.

Zyphor Updates

Installation: zyphor pkg install zyphor-updates

Note: Zyphor Updates is NOT pre-installed and available by default after operating system installation.

Zyphor Updates is the official post-installation package for Zyphor OS. It provides a curated collection of software, developer tools, desktop enhancements, system utilities, multimedia applications, and Zyphor-specific components that extend the base operating system experience.

Zysh

Installation: zyphor pkg install zysh

Note: Zysh is not included in the default Zyphor OS installation. It is automatically installed as part of the zyphor-updates package.

Zysh is the official Zsh customization layer for Zyphor OS. It enhances the standard Zsh shell with Zyphor-specific branding, version information, color schemes, and terminal experience improvements. Rather than replacing Zsh, Zysh operates on top of it, extending and customizing the shell to provide a consistent and recognizable command-line environment across the Zyphor OS ecosystem.