## 1. Project Overview & Quickstart (certimate-go/certimate)

## File: README.md

<h1 align="center">🔒 Certimate</h1>









---

## 🚩 Introduction

An open-source and free self-hosted SSL certificates ACME tool, automates the full-cycle of issuance, deployment, renewal, and monitoring visually.

- **Self-hosted**: Private deployment. All data is stored locally, to ensure data privacy and security.
- **Cross Platforms**: Compatible with various operating systems, including Windows/Linux/macOS.
- **Zero Dependencies**: No need to install databases, runtimes, or any frameworks. Ready to use out of the box.
- **Low Resource Usage**: Extremely lightweight, requiring only ~16 MB of memory.
- **Easy to Use**: Automates certificate management with a visual workflow — all with just a few simple configurations.

## 💡 Features

- Flexible workflow orchestration, fully automation from certificate application to deployment.
- Supports requesting single/multiple/wildcard domain certificates, IP address certificates, with options for RSA or ECC key.
- Supports DNS-01 challenge and HTTP-01 challenge both.
- Supports various certificate formats such as PEM, PFX, JKS.
- Supports more than 70+ domain registrars (e.g., AWS, Cloudflare, GoDaddy, Alibaba Cloud, Tencent Cloud, etc. [Check out full providers](https://docs.certimate.me/en-US/docs/reference/providers#supported-dns-providers)).
- Supports more than 150+ deployment destinations (e.g., Kubernetes, CDN, WAF, load balancers, etc. [Check out full providers](https://docs.certimate.me/en-US/docs/reference/providers#supported-hosting-providers)).
- Supports multiple notification channels including email, Discord, Slack, Telegram, DingTalk, Feishu, WeCom, and more.
- Supports multiple ACME CAs including Let's Encrypt, Actalis, Google Trust Services, SSL.com, ZeroSSL, and more.
- More features waiting to be discovered.

## 🚀 Quick Start

**Run Certimate in 1 minute!**


👉 Binary Installation: 

Download the archived package of precompiled executable files directly from [GitHub Releases](https://github.com/certimate-go/certimate/releases), extract and then execute:

```bash
./certimate serve
```




👉 Docker Installation: 

```bash
docker run -d \
  --name certimate \
  --restart unless-stopped \
  -p 8090:8090 \
  -v /etc/localtime:/etc/localtime:ro \
  -v /etc/timezone:/etc/timezone:ro \
  -v $(pwd)/data:/app/pb_data \
  certimate/certimate:latest
```



Visit `http://127.0.0.1:8090` in your browser.

Default administrator account:

- Username: `admin@certimate.fun`
- Password: `1234567890`

Work with Certimate right now. Or read other content in the documentation to learn more.

## 📄 Documentation

For full documentation, please visit [docs.certimate.me](https://docs.certimate.me/).

Related articles:

> - [_Migrate to v0.4_](https://docs.certimate.me/en-US/docs/migrations/migrate-to-v0.4)
> - [_使用 CNAME 完成 ACME DNS-01 质询_](https://docs.certimate.me/en-US/blog/cname)
> - [_Why Certimate?_](https://docs.certimate.me/en-US/blog/why-certimate)

## 🖥️ Screenshot

[](https://www.youtube.com/watch?v=am_yzdfyNOE)

## 🤝 Contributing

Certimate is a free and open-source project, and your feedback and contributions are needed and always welcome. Contributions include but are not limited to: submitting code, reporting bugs, sharing ideas, or showcasing your use cases based on Certimate. We also encourage users to share Certimate on personal blogs or social media.

For those who'd like to contribute code, see our [Contribution Guide](./CONTRIBUTING.md).

[Issues](https://github.com/certimate-go/certimate/issues) and [Pull Requests](https://github.com/certimate-go/certimate/pulls) are opened at https://github.com/certimate-go/certimate.

#### Contributors

[](https://github.com/certimate-go/certimate/graphs/contributors)

## ⛔ Disclaimer

This repository is available under the [MIT License](https://opensource.org/licenses/MIT), and distributed “as-is” without any warranty of any kind. The authors and contributors are not responsible for any damages or losses resulting from the use or inability to use this software, including but not limited to data loss, business interruption, or any other potential harm.

**No Warranties**: This software comes without any express or implied warranties, including but not limited to implied warranties of merchantability, fitness for a particular purpose, and non-infringement.

**User Responsibilities**: By using this software, you agree to take full responsibility for any outcomes resulting from its use.

## 🌐 Join the Community

- [Telegram](https://t.me/+ZXphsppxUg41YmVl)
- Wechat Group (contact to the author [@usual2970](https://github.com/usual2970) to getting invitation)

  

## ⭐ Star History

Star Certimate on GitHub and be instantly notified of new releases!

<a href="https://www.star-history.com/?repos=certimate-go%2Fcertimate&type=date&legend=bottom-right">
 
   
   
   
 
</a>

---

## File: README_zh.md

<h1 align="center">🔒 Certimate</h1>









---

## 🚩 项目简介

完全开源免费的自托管 SSL 证书 ACME 工具，申请、部署、续期、监控全流程自动化可视化，支持各大主流云厂商。

- **自托管**：私有化安装，所有数据本地化存储，掌控数据的隐私与安全。
- **跨平台**：Windows/Linux/macOS，全平台多架构可运行。
- **零依赖**：无需安装数据库、运行时或复杂框架，一键启动，开箱即用。
- **低占用**：超轻量的资源开销，仅需 ~16 MB 内存。
- **易操作**：图形化界面，通过简单配置即可完成证书的自动化管理。

## 💡 功能特性

- 灵活的工作流编排方式，证书从申请到部署完全自动化。
- 支持申请单/多/泛域名证书、IP 地址证书，可选 RSA、ECC 私钥算法。
- 支持 DNS-01（即基于域名解析验证）、HTTP-01（即基于文件验证）两种质询方式。
- 支持 PEM、PFX、JKS 等多种格式输出证书。
- 支持 70+ 域名托管商（如阿里云、腾讯云、AWS、Cloudflare、GoDaddy 等，[点此查看完整清单](https://docs.certimate.me/zh-CN/docs/reference/providers#supported-dns-providers)）。
- 支持 150+ 部署目标（如 Kubernetes、CDN、WAF、负载均衡等，[点此查看完整清单](https://docs.certimate.me/zh-CN/docs/reference/providers#supported-hosting-providers)）。
- 支持邮件、钉钉、飞书、企业微信、Discord、Slack、Telegram 等多种通知渠道。
- 支持 Let's Encrypt、Actalis、Google Trust Services、SSL.com、ZeroSSL 等多种 ACME 证书颁发机构。
- 更多特性等待探索。

## 🚀 快速启动

**1 分钟运行 Certimate！**


👉 二进制安装：

从 [GitHub Releases](https://github.com/certimate-go/certimate/releases) 页面下载预先编译好的可执行文件压缩包，解压缩后在终端中执行：

```bash
./certimate serve
```




👉 Docker 安装：

```bash
docker run -d \
  --name certimate \
  --restart unless-stopped \
  -p 8090:8090 \
  -v /etc/localtime:/etc/localtime:ro \
  -v /etc/timezone:/etc/timezone:ro \
  -v $(pwd)/data:/app/pb_data \
  certimate/certimate:latest
```



浏览器中访问 `http://127.0.0.1:8090`。

初始的管理员账号及密码：

- 账号：`admin@certimate.fun`
- 密码：`1234567890`

即刻使用 Certimate。或者阅读文档中的其他内容以了解更多。

## 📄 使用手册

请访问文档站 [docs.certimate.me](https://docs.certimate.me/) 以阅读使用手册。

> （由于众所周知的原因，中国大陆用户可能需要 🪄 上网才能访问文档站。）

相关文章：

> - [《升级指南：迁移到 v0.4》](https://docs.certimate.me/zh-CN/docs/migrations/migrate-to-v0.4)
> - [《使用 CNAME 完成 ACME DNS-01 质询》](https://docs.certimate.me/zh-CN/blog/cname)
> - [《Why Certimate?》](https://docs.certimate.me/zh-CN/blog/why-certimate)

## 🖥️ 运行界面

[](https://www.bilibili.com/video/BV1xockeZEm2)

## 🤝 参与贡献

Certimate 是一个免费且开源的项目。我们欢迎任何人为 Certimate 做出贡献，以帮助改善 Certimate。包括但不限于：提交代码、反馈缺陷、交流想法，或分享你基于 Certimate 的使用案例。同时，我们也欢迎用户在个人博客或社交媒体上分享 Certimate。

如果你想要贡献代码，请先阅读我们的[贡献指南](./CONTRIBUTING_zh.md)。

请在 https://github.com/certimate-go/certimate 提交 [Issues](https://github.com/certimate-go/certimate/issues) 和 [Pull Requests](https://github.com/certimate-go/certimate/pulls)。

#### 感谢以下贡献者对 Certimate 做出的贡献：

[](https://github.com/certimate-go/certimate/graphs/contributors)

## ⛔ 免责声明

Certimate 遵循 [MIT License](https://opensource.org/licenses/MIT) 开源协议，完全免费提供，旨在“按现状”供用户使用。作者及贡献者不对使用本软件所产生的任何直接或间接后果承担责任，包括但不限于性能下降、数据丢失、服务中断、或任何其他类型的损害。

**无任何保证**：本软件不提供任何明示或暗示的保证，包括但不限于对特定用途的适用性、无侵权性、商用性及可靠性的保证。

**用户责任**：使用本软件即表示您理解并同意承担由此产生的一切风险及责任。

## 🌐 加入社群

- [Telegram](https://t.me/+ZXphsppxUg41YmVl)
- 微信群聊（因微信自身限制需群主邀请，可先加 [@usual2970](https://github.com/usual2970) 好友）

  

## ⭐ 星标趋势

在 GitHub 上为 Certimate 添加 Star 星标关注，即可第一时间获取新版本发布通知！

<a href="https://www.star-history.com/?repos=certimate-go%2Fcertimate&type=date&legend=bottom-right">
 
   
   
   
 
</a>

## 2. Official Technical Reference & Guides (certimate-go/docs)

# 📄 Documentation for [Certimate](https://github.com/certimate-go/certimate)

Please visit [docs.certimate.me](https://docs.certimate.me/).

## Contributing

This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator. Site content is written in Markdown format located in `docs`. For simple edits, you can directly edit the file on GitHub and generate a Pull Request.

### Installation

```shell
> npm install
```

### Local Development

```shell
> npm run start
```

This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.

### Build

```shell
> npm run build
```

This command generates static content into the `build` directory and can be served using any static contents hosting service.