acme.sh/README.md

Skip to content
Pull requests
Issues
Marketplace
Explore
@stilez
Learn Git and GitHub without any code!

Using the Hello World guide, you’ll start a branch, write comments, and open a pull request.

395
14.7k

    1.9k

Neilpang/acme.sh
Code
Issues 415
Pull requests 110
Actions
Projects 0
Wiki
Security
Insights
You’re editing a file in a project you don’t have write access to. Submitting a change to this file will write it to a new branch in your fork stilez/acme.sh, so you can send a pull request.
acme.sh/

1

# An ACME Shell script: acme.sh [![Build Status](https://travis-ci.org/Neilpang/acme.sh.svg?branch=master)](https://travis-ci.org/Neilpang/acme.sh)

2

​

3

<a href="https://opencollective.com/acmesh" alt="Financial Contributors on Open Collective"><img src="https://opencollective.com/acmesh/all/badge.svg?label=financial+contributors" /></a> [![Join the chat at https://gitter.im/acme-sh/Lobby](https://badges.gitter.im/acme-sh/Lobby.svg)](https://gitter.im/acme-sh/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

4

- An ACME protocol client written purely in Shell (Unix shell) language.

5

- Full ACME protocol implementation.

6

- Support ACME v1 and ACME v2

7

- Support ACME v2 wildcard certs

8

- Simple, powerful and very easy to use. You only need 3 minutes to learn it.

9

- Bash, dash and sh compatible.

10

- Simplest shell script for Let's Encrypt free certificate client.

11

- Purely written in Shell with no dependencies on python or the official Let's Encrypt client.

12

- Just one script to issue, renew and install your certificates automatically.

13

- DOES NOT require `root/sudoer` access.

14

- Docker friendly

15

- IPv6 support

16

- Cron job notifications for renewal or error etc.

17

​

18

It's probably the `easiest & smartest` shell script to automatically issue & renew the free certificates from Let's Encrypt.

19

​

20

Wiki: https://github.com/Neilpang/acme.sh/wiki

21

​

22

For Docker Fans: [acme.sh :two_hearts: Docker ](https://github.com/Neilpang/acme.sh/wiki/Run-acme.sh-in-docker)

23

​

24

Twitter: [@neilpangxa](https://twitter.com/neilpangxa)

25

​

26

​

27

# [中文说明](https://github.com/Neilpang/acme.sh/wiki/%E8%AF%B4%E6%98%8E)

28

​

29

# Who:

30

- [FreeBSD.org](https://blog.crashed.org/letsencrypt-in-freebsd-org/)

31

- [ruby-china.org](https://ruby-china.org/topics/31983)

32

- [Proxmox](https://pve.proxmox.com/wiki/HTTPS_Certificate_Configuration_(Version_4.x_and_newer))

33

- [pfsense](https://github.com/pfsense/FreeBSD-ports/pull/89)

34

- [webfaction](https://community.webfaction.com/questions/19988/using-letsencrypt)

35

- [Loadbalancer.org](https://www.loadbalancer.org/blog/loadbalancer-org-with-lets-encrypt-quick-and-dirty)

36

- [discourse.org](https://meta.discourse.org/t/setting-up-lets-encrypt/40709)

37

- [Centminmod](https://centminmod.com/letsencrypt-acmetool-https.html)

38

- [splynx](https://forum.splynx.com/t/free-ssl-cert-for-splynx-lets-encrypt/297)

39

- [archlinux](https://www.archlinux.org/packages/community/any/acme.sh)

40

- [opnsense.org](https://github.com/opnsense/plugins/tree/master/security/acme-client/src/opnsense/scripts/OPNsense/AcmeClient)

41

- [CentOS Web Panel](http://centos-webpanel.com/)

42

- [lnmp.org](https://lnmp.org/)

43

- [more...](https://github.com/Neilpang/acme.sh/wiki/Blogs-and-tutorials)

44

​

45

# Tested OS

46

​

47

| NO | Status| Platform|

@stilez
Propose file change
Commit summary
Optional extended description

    © 2019 GitHub, Inc.
    Terms
    Privacy
    Security
    Status
    Help

    Contact GitHub
    Pricing
    API
    Training
    Blog
    About