Exit Codes

Exit Codes

SSI uses the following exit codes, following standard Unix conventions.

Success

• 0 — Success

General Errors (1–9)

• 1 — General error
• 2 — Invalid command-line argument
• 3 — Configuration error (bad ssi-config.toml)
• 4 — File source error (problem reading or processing a file source)
• 5 — Include source error (problem resolving an include source)
• 6 — Processing error (error during token replacement or page generation)
• 7 — (unassigned)
• 8 — Dependency error (missing required external tool)
• 9 — Security error (path traversal or other security violation)

Deployment Errors (10–19)

• 10 — Output directory removal failed completely (atomic deploy cleanup error)
• 11 — Output directory removal failed partially (atomic deploy cleanup error)

Validation Errors (50–59)

• 50 — Configuration validation failed
• 51 — (reserved)
• 52 — Content validation failed (HTML, accessibility, links, or assets)
• 53 — Strict mode violation (warning treated as error via --strict)

Special Codes

• 255 — Fatal or unexpected internal error