Skip to content

NetBox SSL

Project Janus — Your Single Source of Truth for TLS/SSL certificate management in NetBox.

PyPI License NetBox Status


What is NetBox SSL?

NetBox SSL is a plugin that brings visibility and control to your certificate lifecycle. Track every TLS certificate in your infrastructure, see where it's deployed, and never let one expire unnoticed.

Named after Janus, the Roman god of doorways and transitions — because every certificate guards a doorway, and every renewal is a transition.

Pick your path

  • New to NetBox SSL?


    Start with the Tutorials to learn step-by-step.

    First Import

  • Solving a specific problem?


    Jump to How-To Guides for task-oriented help.

    How-To Guides

  • Building integrations?


    Browse the Reference for API, data models, and configuration.

    Reference

  • Operating NetBox SSL in production?


    See Operations for installation, upgrades, and load testing.

    Operations

  • Understanding the design?


    Read the Explanation docs for architecture and rationale.

    Explanation

  • Contributing?


    See the Development section for contributor setup and policies.

    Contributing

What can you do?

Track all your certificates

Import certificates with a simple paste — the plugin extracts every X.509 attribute. Private keys are rejected by design; only public metadata is stored.

Seamless renewals with the Janus workflow

When you renew, all assignments transfer automatically from the old certificate to the new one, and the old one is archived. Full audit trail, atomic operation.

Know where every certificate lives

Assign certificates to Services, Devices, or Virtual Machines. See at a glance which infrastructure depends on which certificate.

Proactive expiry alerts

Scheduled scans + NetBox Event Rules + webhooks → Slack, Teams, or PagerDuty notifications long before anything breaks.

Compliance and analytics

Define compliance policies, monitor a score over time, visualise the expiry forecast, and export reports in CSV or JSON.

Community

  • GitHub — source, issues, PRs
  • PyPI — install with pip install netbox-ssl
  • Apache 2.0 licensed — free for commercial use

Contributing

We welcome contributions! See the Contributing guide to get started, or jump straight to good first issues.