Skip to content

Land the redesigned docs tree (phase 1) #557

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
joshdrake merged 1 commit into from
Sep 13, 2026
Merged

Land the redesigned docs tree (phase 1) #557

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
90 changes: 65 additions & 25 deletions README.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,61 +2,101 @@
disableSidebar: true
---

## Start here

<div className="grid grid-cols-1 sm:grid-cols-2 md:grid-cols-3 gap-spacing-6">
<IndexCard
className="text-blue-500"
iconSrc="https://smallstep-cms-images.s3.us-east-2.amazonaws.com/icon_platforms_2.svg"
title="Platform"
description="Quickly and reliably connect devices, workloads, and people using end-to-end encryption."
title="I’m evaluating"
description="Understand what device identity is and why hardware attestation changes the security model."
href="/docs/platform/"
/>
<IndexCard
className="text-blue-500"
iconSrc="https://smallstep-cms-images.s3.us-east-2.amazonaws.com/icon_ssh_1_70b1ab2d27.svg"
title="Smallstep SSH"
description="Smallstep SSH, seamless SSH access with zero key management. Product documentation."
href="/docs/ssh"
iconSrc="https://smallstep-cms-images.s3.us-east-2.amazonaws.com/icon_platforms_2.svg"
title="I’m building"
description="Get a first device onto a first resource. Start with Wi-Fi: about twenty minutes plus your access-point change."
href="/docs/tutorials/protect-wireless-networks/"
/>
<IndexCard
className="text-blue-500"
iconSrc="https://smallstep-cms-images.s3.us-east-2.amazonaws.com/icon_certificate_manager_1_86b2f377b7.svg"
title="Certificate Manager"
description="Smallstep Certificate Manager, your hosted certificate authority. Product documentation."
href="/docs/certificate-manager/"
iconSrc="https://smallstep-cms-images.s3.us-east-2.amazonaws.com/icon_platforms_2.svg"
title="I’m operating"
description="Run the platform: inventory, trust, credentials, policy, and audit."
href="/docs/platform/enrollment-guide/"
/>
</div>

## Use cases

<div className="grid grid-cols-1 sm:grid-cols-2 md:grid-cols-4 gap-spacing-6">
<IndexCard
className="text-blue-500"
iconSrc="https://smallstep-cms-images.s3.us-east-2.amazonaws.com/icon_registration_autohorities_1_0006dbd36d.svg"
title="Registration Authorities"
description="Smallstep Registration Authorities, extend your existing PKI. Product documentation."
href="/docs/registration-authorities/"
iconSrc="https://smallstep-cms-images.s3.us-east-2.amazonaws.com/icon_platforms_2.svg"
title="Wi-Fi"
description="EAP-TLS with hardware-attested device credentials."
href="/docs/tutorials/protect-wireless-networks/"
/>
<IndexCard
className="text-blue-500"
iconSrc="https://smallstep-cms-images.s3.us-east-2.amazonaws.com/icon_platforms_2.svg"
title="Wired"
description="802.1X on your switches."
href="/docs/tutorials/protect-wired-networks/"
/>
<IndexCard
className="text-blue-500"
iconSrc="https://smallstep-cms-images.s3.us-east-2.amazonaws.com/icon_platforms_2.svg"
title="VPN"
description="Certificate-based VPN with strongSwan, F5, or Azure."
href="/docs/tutorials/vpn-setup-guide/"
/>
<IndexCard
className="text-blue-500"
iconSrc="https://smallstep-cms-images.s3.us-east-2.amazonaws.com/icon_mutual_tls_1_0960977120.svg"
title="Web apps"
description="Browser mTLS for Entra, Okta, and your own apps."
href="/docs/tutorials/browser-certificate-setup-guide/"
/>
<IndexCard
className="text-blue-500"
iconSrc="https://smallstep-cms-images.s3.us-east-2.amazonaws.com/icon_ssh_1_70b1ab2d27.svg"
title="SSH"
description="Hosts, users, and GitHub with SSH certificates."
href="/docs/ssh/"
/>
<IndexCard
className="text-blue-500"
iconSrc="https://smallstep-cms-images.s3.us-east-2.amazonaws.com/icon_certificate_manager_1_86b2f377b7.svg"
title="Workloads"
description="Certificates for services on your hosts and in Kubernetes."
href="/docs/certificate-manager/kubernetes-tls/"
/>
</div>

## Open source

<div className="grid grid-cols-1 sm:grid-cols-2 md:grid-cols-3 gap-spacing-6">
<IndexCard
className="text-blue-900"
iconSrc="https://smallstep-cms-images.s3.us-east-2.amazonaws.com/icon_step_cli_1_9eca92f992.svg"
title="step CLI"
description="Streamline PKI and crypto operations with our open source command line toolchain."
description="The open source command-line toolchain for PKI and crypto operations."
href="/docs/step-cli/"
/>
<IndexCard
className="text-blue-900"
iconSrc="https://smallstep-cms-images.s3.us-east-2.amazonaws.com/icon_step_ca_1_342e1dcdd6.svg"
title="step-ca"
description="Run your open source Certificate Authority (CA) and PKI. Issue certificates to everything."
description="Run your own certificate authority. Smallstep’s hosted authorities run it too."
href="/docs/step-ca/"
/>
<IndexCard
className="text-blue-900"
iconSrc="https://smallstep-cms-images.s3.us-east-2.amazonaws.com/icon_mutual_tls_1_0960977120.svg"
title="Mutual TLS"
description="Instructions and code for connecting apps, systems, and workloads using mTLS."
href="/docs/mtls/"
/>
<IndexCard
className="text-blue-900"
iconSrc="https://smallstep-cms-images.s3.us-east-2.amazonaws.com/icon_tutorials_1_0d50c76b6a.svg"
title="Tutorials"
description="Deploy the `step` toolchain across popular deployment scenarios. Learn by doing."
title="step-ca tutorials"
description="Deploy the step toolchain across popular scenarios. Learn by doing."
href="/docs/tutorials/"
/>
</div>
5 changes: 5 additions & 0 deletions certificate-manager/README.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,11 @@ html_title: Certificate Manager Documentation Hub Overview
description: Complete guide to Smallstep Certificate Manager. Simplify enterprise PKI with automated certificate lifecycle management at scale easily.
---

<Alert severity="info">
<AlertTitle>Certificate Manager is now part of Trust</AlertTitle>
<div>The hosted certificate authority, its authorities, issuance methods, templates, and certificates are documented under the platform's Trust and Credentials sections. These pages stay while that move completes, and every link to them keeps working.</div>
</Alert>

Smallstep Certificate Manager is a commercial product built on `step-ca` that delivers a highly available hosted certificate authorities, expiry notifications and alerts, a management console, Active Revocation, API, and other features. With Smallstep Certificate Manager, you can easily issue private TLS/SSL certificates to all your things. [Learn more here.](https://smallstep.com/certificate-manager)

If you need to manage devices or workloads that are not supported yet, then you can use Certificate Manager to tinker a solution.
Expand Down
8 changes: 8 additions & 0 deletions learn/how-smallstep-hosts-step-ca.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
updated_at: September 13, 2026
title: How Smallstep hosts step-ca
html_title: How Smallstep hosts step-ca
description: What a hosted authority shares with open-source step-ca, what the platform adds, and which page to read for each job.
---

A hosted authority is a step-ca. This page will say what is the same (provisioner types, which the platform calls issuance methods; templates; ACME; issuance policies; webhooks), what the platform adds (an inventory, hardware-attested issuance, credentials, verifiers, policy modes, audit), and which page to read for each job. Until it lands, the open-source [step-ca documentation](../step-ca/README.mdx) describes the shared mechanics.
Loading
Loading