ademidovx/tf-mirror repository overview

⁠Terraform Registry Mirror

A fast, robust, and flexible self-hosted mirror for the Terraform Provider Registry and HashiCorp tool binaries. Designed for air-gapped, enterprise, and CI/CD environments, it supports advanced filtering, Prometheus metrics, and multiple deployment options.

⁠Features

• Provider & Binary Mirroring: Downloads and serves Terraform providers and HashiCorp CLI tools.
• Advanced Filtering: Filter by provider, version, platform, and tool.
• Prometheus Metrics: Built-in /metrics endpoint for monitoring.
• Flexible Deployment: Run as a binary, Docker container, or via Helm in Kubernetes.
• Atomic Metadata: Generates index.json and .tf-mirror-metadata.json compatible with Terraform.
• TLS Support: Optional HTTPS for secure serving.
• Health & Version Endpoints: For easy monitoring and automation.
• Single-Pod Mode: Downloader and server can run together with a shared data volume.
• Multi-Stage Docker Build: Optimized for smaller image size.
• Proxy support: HTTP/HTTPS/SOCKS5 proxy support.

⁠Manual Docker Run

docker run --rm -v $(pwd)/data:/data docker.io/ademidovx/tf-mirror:latest \
  --mode downloader --download-path /data --provider-filter=hashicorp/aws
docker run --rm -p 8080:8080 -v $(pwd)/data:/data docker.io/ademidovx/tf-mirror:latest \
  --mode server --data-path /data --listen-port 8080

⁠Command Line Options

⁠Environment Variables

Repo: https://github.com/kashtan404/tf-mirror⁠