https://github.com/ahuahuachi/traefik-cert-exporter
CLI and python library to export Traefik SSL certificates
https://github.com/ahuahuachi/traefik-cert-exporter
certificate cli docker docker-compose docker-image export python ssl traefik
Last synced: 5 months ago
JSON representation
CLI and python library to export Traefik SSL certificates
- Host: GitHub
- URL: https://github.com/ahuahuachi/traefik-cert-exporter
- Owner: Ahuahuachi
- License: mit
- Created: 2024-06-30T04:23:33.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-07-11T02:28:01.000Z (almost 2 years ago)
- Last Synced: 2025-09-25T12:38:40.206Z (9 months ago)
- Topics: certificate, cli, docker, docker-compose, docker-image, export, python, ssl, traefik
- Language: Python
- Homepage:
- Size: 31.3 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Traefik Cert Exporter
CLI and python library to export [Traefik](https://traefik.io/traefik/) SSL certificates.
This project is intended to provide tools to automate the process of extracting the certificates generated by [Traefik's automatic certificate generation](https://doc.traefik.io/traefik/https/acme)
Project based on the excelent work on [Traefik SSL Certificate Exporter](https://github.com/rafi0101/traefik-ssl-certificate-exporter)
## Python library
You can use the python library on your own automation scripts
### Installation
```bash
pip install traefik-cert-exporter
```
### Usage
```python
from traefik_cert_exporter import export_certificates
acme_file = "./acme.json"
output_dir = "./certs"
export_certificates(acme_file, output_dir)
```
## CLI
You can use the included CLI directly from the terminal
### Installation
```bash
pip install traefik-cert-exporter
```
### Usage
```bash
export-certs ./acme.json ./certs
```
## Docker
There is also a Docker image that create a cron job that runs the certificate export process on a schedule.
The container needs to have access to the store file generated by Traefik, so it needs to be configured with the correct variables to run successfully.
You can use the docker compose example to create your own environment.
image: https://hub.docker.com/r/ahuahuachi/traefik-cert-exporter
### Environment Variables
| Variable | Default value | Description |
| ------------- | ------------------- | ------------------------------------------------- |
| CRON_SCHEDULE | `0 0 1 * *` | Cron schedule to run the extraction script |
| STORAGE_FILE | `traefik/acme.json` | Path to the acme storage file |
| OUTPUT_PATH | `certs/` | Path where the certs are going to be extracted to |
| ON_START | `1` (true) | Run export scripts once when container starts |
### Docker compose example
Traefik's static configuration file
```yaml
# static.yaml
certificatesResolvers:
myresolver:
acme:
storage: "/config/acme.json"
...
```
```yaml
# docker-compose.yaml
version: "3"
services:
cert-exporter:
image: ahuahuachi/traefik-cert-exporter:latest
environment:
- STORAGE_FILE="/config/acme.json"
- OUTPUT_PATH="/certs"
volumes:
- traefik-config:/config/
- ./certs:/certs
traefik:
image: traefik:latest
volumes:
- traefik-config:/config/
...
volumes:
traefik-config:
```