Skip to content

// docs · procedures

Procedures

Short, do-this-now SOPs for operating syscert. Each one stands alone and is built to drop into your own ops manual.

These are formal operating procedures for syscert, the terse “do this now” layer. They don’t replace the rest of the docs. The explanatory what and why live in Quick start, Configuration, Advanced install, Distributing certs, and Troubleshooting, and each procedure links back into those instead of repeating the detail.

Every procedure follows the same fixed structure: purpose, scope, prerequisites, numbered steps with exact commands, verification, and rollback. Copy one straight into a runbook, or reference it from your ops manual.

Download all procedures: syscert-procedures.zip gives you one Markdown file per procedure (named by Procedure ID, frontmatter stripped), ready to drop into your own ops manual.

Procedure index

IDProcedureWhen you’d use it
SC-OPS-001Install & deploySetting up syscert on a new host for the first time.
SC-OPS-002Change certificate details & reissueAdding or removing SANs, changing the key type or issuance profile, then forcing a fresh certificate.
SC-OPS-003Force an immediate renewalRenewing the certificate right now without any config change — expiry bypass.
SC-OPS-004Rotate the private keyRotating to a fresh keypair, or clearing reuse_key to do so explicitly.
SC-OPS-005Revoke and replace (void)Revoking the current certificate at the CA and immediately reissuing a replacement.
SC-OPS-006Migrate to a different CASwitching from one ACME CA to another — new account, fresh order, optional EAB.
SC-OPS-007Manage distribution targetsAdding, changing, or removing [[distribute]] blocks and pushing the new delivery config.
SC-OPS-008Trust an internal CA system-wideInstalling or removing an internal CA’s root in the system trust store.
SC-OPS-009Upgrade syscertIn-place binary swap to a new version via the one-liner or install.sh.
SC-OPS-010Uninstall or purgeRemoving syscert — keeping data with --uninstall or wiping everything with --purge.
SC-OPS-011Recover from a broken stateWiping all cert state with destroy and re-provisioning from scratch.