HEXSSL-CLI

Official CLI tool from HEXSSL

HEXSSL-CLI

A modern command-line tool for diagnostics related to trust, TLS, certificates, DNS, mail security, and HSTS. Designed for system administrators, DevOps, SRE, and security teams that need to perform fast, repeatable, and technical tests directly from the terminal.

Key features

  • CLI-first
  • trust and TLS diagnostics
  • cert, DNS, mail, and HSTS
  • human-readable output and JSON
  • automation and CI/CD
What is HEXSSL-CLI?

A technical tool for everyday diagnostics

HEXSSL-CLI was created as a practical operational tool for verifying selected aspects of trust and the security of published services. It makes it possible to analyze certificates, DNS, mail trust, and HSTS locally, on an administrative server, in scripts, or within deployment pipelines.

It is a solution for environments where verification speed, repeatability of results, and the ability to easily integrate tests into an internal technical process all matter.

CLI first

CLI-first

Fast tests launched directly from the terminal, without unnecessary intermediary layers.

Modularity

Modularity

Separate validation areas for TLS, certificates, DNS, mail trust, and HSTS.

Automation

Automation

A strong fit for scripts, operational workflows, and CI/CD.

Practical

Practical use

A project focused on real operational and post-deployment use cases.

Capabilities

What can HEXSSL-CLI do?

cert check

Checks the TLS certificate and baseline deployment parameters for a selected host.

dns check

Validates DNS records in the context of configuration correctness and baseline hardening.

mail check

Analyzes selected aspects of mail trust for a domain using the specified selector.

hsts check

Verifies HSTS header correctness and domain behavior in the context of transport security.

hsts preload

Assesses preload readiness and compliance with stricter HSTS configuration requirements.

hsts redirects

Analyzes the redirect chain and the transition from HTTP to HTTPS.

hsts scan

Provides multi-path scanning across multiple application paths, useful in complex deployments.

hsts audit

Runs a full audit with grading, helping to quickly assess the current configuration state.

Use cases

Where does HEXSSL-CLI deliver real value?

HEXSSL-CLI works best wherever teams need to quickly confirm the state of a domain or service after technical changes. It can be used after deploying a new certificate, after DNS changes, during mail trust verification, while checking HSTS and preload readiness, and as part of standard quality checks before publishing changes to production.

It is also a convenient solution for administrators managing multiple domains, maintenance service providers, and teams that want to standardize the first line of technical diagnostics.

Typical scenarios

  • certificate validation after deployment
  • testing after DNS changes
  • mail trust verification for a domain
  • HSTS validation before preload
  • redirect chain analysis
  • smoke tests after production changes
  • repeatable checks across multiple services

Not just online tools

Web-based tools are convenient for a single test. But when greater control, repeatability, script-based execution, or easier integration with an internal technical workflow is needed, a CLI approach offers significantly more flexibility.

HEXSSL-CLI extends the HEXSSL ecosystem with a terminal-based layer designed for administrators, DevOps, and security teams that want to work faster and more predictably.

Contact us
Quick start

Example usage

pip install hexssl-cli

hexssl-cli cert check example.com
hexssl-cli cert check example.com --json

hexssl-cli dns check example.com
hexssl-cli dns check example.com --json

hexssl-cli mail check example.com --selector default
hexssl-cli mail check example.com --selector default --json

hexssl-cli hsts check example.com
hexssl-cli hsts preload example.com
hexssl-cli hsts redirects example.com
hexssl-cli hsts scan example.com --paths "/,/login,/api,/admin"
hexssl-cli hsts audit example.com
Output and integration

Results ready for operational use

HEXSSL-CLI provides readable output for operators as well as JSON format for automation, making it easier to integrate with internal scripts, reporting, and CI/CD pipelines.

The project also uses explicit exit codes, which makes results easy to interpret in automated environments and technical workflows.

Exit codes

  • 0 — OK
  • 1 — Warning / issues detected
  • 2 — Failure / corrective action required
  • 10 — Input or usage error
  • 11 — Network or timeout error
  • 12 — Parsing or validation error
Who is it for?

Who benefits from HEXSSL-CLI?

HEXSSL-CLI was designed for individuals and teams that work close to infrastructure, service configuration, and the security of web service publishing. It is especially well suited to environments where fast diagnosis, technical control of changes, and easy repeatability of tests matter.

  • system administrators
  • DevOps and SRE teams
  • security engineers
  • hosting providers and MSPs
  • integrators and software houses
  • maintenance teams managing multiple domains
Release Log

Key changes across subsequent HEXSSL-CLI versions

Here we publish the most important project updates, new modules, and functional changes introduced in subsequent versions of the tool.

v0.2.0

Release date: 10.04.2026

Version 0.2.0 significantly expands the capabilities of HEXSSL-CLI and moves the project beyond its earlier, narrower functional scope.

  • added cert check
  • added dns check
  • added mail check –selector
  • shared core for result models, formatters, and exit codes
  • human-readable and JSON output for new modules
  • initial CLI tests for cert, DNS, and mail modules

View the release on GitHub
View the changelog

Project development

HEXSSL-CLI is being developed as a practical technical tool for the everyday diagnostics of trust and service publication security.

The release history section will be expanded with future versions, including the most important changes, new modules, and links to relevant release notes on GitHub.

View all releases on GitHub

HEXSSL-CLI updates

HEXSSL-CLI

Check it out at:Go to GitHub

Add A Knowledge Base Question !

You will receive an email when your question will be answered.

+ = Verify Human or Spambot ?