From 262e9bc8e697d674e0bc348c5108f6ecc11c74cf Mon Sep 17 00:00:00 2001 From: Khalid Saifullah Khan Date: Thu, 22 Oct 2026 14:55:39 +0530 Subject: [PATCH] docs: README header with logo, badges, split quick start Logo header, release/CI/CodeQL/pkg.go.dev badges, a link row, the pre-release note near the top, the quick start split by install method (with the real RPM file name), and a screenshot that follows dark mode. --- README.md | 72 ++++++++++++++++++++++++++++++++++++++++++------------- 1 file changed, 56 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index b6fd3c3..3699038 100644 --- a/README.md +++ b/README.md @@ -1,32 +1,74 @@ -# CipherHorizon - -[![CI](https://github.com/offsetsecurity/cipherhorizon/actions/workflows/ci.yml/badge.svg)](https://github.com/offsetsecurity/cipherhorizon/actions/workflows/ci.yml) -[![Go Reference](https://img.shields.io/badge/go-1.27%2B-00ADD8?logo=go&logoColor=white)](go.mod) -[![License: Apache 2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE) -[![CycloneDX](https://img.shields.io/badge/CBOM-CycloneDX%201.7-2457d6)](docs/exporting.md) - +

+ +

+ +

CipherHorizon

+ +

+ Latest release + CI + CodeQL +
+ Go version + Go Reference + CBOM: CycloneDX 1.7 + License: Apache 2.0 +

+ +

+ Quick start · + Features · + How it compares · + Methodology · + Downloads +

**Post-quantum readiness for the protocols your organisation runs on: TLS, SSH and, next, VPN. A deep scan of each, a readiness level from L0 to L4, and one CycloneDX CBOM, self-hosted.** By [Offset Security](https://offsetsecurity.net/). +> [!NOTE] +> **Pre-release (`0.x`).** It works and is tested against real servers, but options and the API may still change +> before 1.0 ([release checklist](docs/engineering/RELEASE-CHECKLIST-1.0.md)). + Recorded traffic is protected today only if the key exchange was post-quantum: NIST IR 8547 deprecates the quantum-vulnerable algorithms after 2030 and disallows them after 2035, and anything harvested before then can be decrypted later. CipherHorizon tells you which of your TLS endpoints and SSH servers are exposed, which machines carry quantum-vulnerable cryptography, and what to fix first. It runs on your network and sends nothing anywhere. -![The Overview: a scan box, the L0 to L4 readiness scale across TLS endpoints and SSH servers, and a card per protocol](docs/img/overview.png) + + + The Overview: a scan box, the L0 to L4 readiness scale across TLS endpoints and SSH servers, and a card per protocol + ## Quick start +Pick one. Downloads (Linux, macOS, Windows; amd64 and arm64) are on the [Releases page](../../releases). + +**Docker or Podman** + +```sh +docker compose up -d # or: podman compose up -d +``` + +**Debian, Ubuntu** (on RHEL or Fedora: `sudo dnf install ./cipherhorizon--1.x86_64.rpm`) + ```sh -docker compose up -d # or: podman compose up -d -sudo apt install ./cipherhorizon__amd64.deb # Debian, Ubuntu (dnf install … .rpm on RHEL, Fedora) -cipherhorizon.exe service install # Windows, as administrator: a service that starts at boot -cipherhorizon serve # any OS, from the release archive, in this terminal +sudo apt install ./cipherhorizon__amd64.deb ``` -Downloads (Linux, macOS, Windows; amd64 and arm64) are on the [Releases page](../../releases). Each OS, where the -data lives, backup, upgrade and removal: [docs/engineering/INSTALL.md](docs/engineering/INSTALL.md). +**Windows**, in a terminal run as administrator: a service that starts at boot + +```powershell +cipherhorizon.exe service install +``` + +**Any OS**, from the release archive, running in this terminal + +```sh +cipherhorizon serve +``` + +Each OS, where the data lives, backup, upgrade and removal: [docs/engineering/INSTALL.md](docs/engineering/INSTALL.md). Open , type an address, press Enter. Sign-in is off until you want it: turn it on in **Settings** to give a team accounts and roles, or start with `--sign-in on`. @@ -191,8 +233,6 @@ Bug reports, corrections to a finding or a citation, and pull requests are welco [CONTRIBUTING.md](CONTRIBUTING.md) for the setup, conventions and the evidence rule every finding follows. Everyone participating follows the [Code of Conduct](CODE_OF_CONDUCT.md). -**Status:** pre-release (`0.x`), heading for 1.0 ([release checklist](docs/engineering/RELEASE-CHECKLIST-1.0.md)). - ## License and credits [Apache 2.0](LICENSE). Made by [Offset Security](https://offsetsecurity.net/), whose