Files
gorkem-bwl a7895cce32 fix(docs): serve docs site at root of Vercel domain
Astro's base option was set to /docs to anticipate the reverse-proxy
URL at checkmate.so/docs. Vercel serves the dist folder at the root,
which made every page 404 because Astro had baked /docs/ into every
internal link and asset URL.

## Changes
- Remove base: "/docs" from astro.config.mjs — site now serves at root
- Update Releases nav link to /releases
- Update README's reverse-proxy snippet to strip the /docs prefix
  before forwarding to Vercel

## Final URL behaviour
- Direct: https://<vercel-domain>/                  → Introduction
- Direct: https://<vercel-domain>/releases/         → Releases
- Proxy:  https://checkmate.so/docs/                → strip /docs → Introduction
- Proxy:  https://checkmate.so/docs/releases/       → strip /docs → Releases
2026-05-22 14:26:51 -04:00
..

Checkmate Documentation

Welcome to the Checkmate documentation. This directory contains guides and references for various aspects of Checkmate deployment and configuration.

Available Documentation

Deployment & Configuration

Docker Configuration

Custom CA Trust

If you need to monitor internal HTTPS endpoints with certificates from private Certificate Authorities (like Smallstep), see our custom CA trust documentation:

Example Configurations

The docker/dev/ directory contains example configurations:

  • docker-compose.custom-ca-example.yaml - Example Docker Compose with custom CA
  • server-custom-ca.Dockerfile - Example Dockerfile for OS-level CA trust
  • export-smallstep-ca.sh - Helper script for Smallstep CA export

Contributing to Documentation

If you find issues or want to improve the documentation:

  1. Check existing issues and discussions
  2. Submit a pull request with your changes
  3. Follow the same markdown formatting style
  4. Include practical examples and code snippets

Getting Help