{"id":21809039,"url":"https://github.com/abxvn/autossl","last_synced_at":"2025-04-13T21:35:21.845Z","repository":{"id":100310234,"uuid":"194529114","full_name":"abxvn/autossl","owner":"abxvn","description":":lock: Shell tool to help secure your applications with free SSL certificates","archived":false,"fork":false,"pushed_at":"2020-04-08T13:41:46.000Z","size":68,"stargazers_count":5,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-27T11:51:18.359Z","etag":null,"topics":["aws","cloud","free","gcloud","shell-script","ssl","ssl-certificate"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/abxvn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-06-30T15:03:55.000Z","updated_at":"2022-09-05T17:32:16.000Z","dependencies_parsed_at":"2023-04-25T21:48:19.800Z","dependency_job_id":null,"html_url":"https://github.com/abxvn/autossl","commit_stats":null,"previous_names":["abxvn/autossl"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abxvn%2Fautossl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abxvn%2Fautossl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abxvn%2Fautossl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abxvn%2Fautossl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abxvn","download_url":"https://codeload.github.com/abxvn/autossl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248788302,"owners_count":21161721,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","cloud","free","gcloud","shell-script","ssl","ssl-certificate"],"created_at":"2024-11-27T13:18:12.262Z","updated_at":"2025-04-13T21:35:21.813Z","avatar_url":"https://github.com/abxvn.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AutoSSL\n\nHelp you secure your applications with free SSL certificates. This tool is designed for simple and straightforward usage, for more complex and wider supported of OS, please use [https://acme.sh/](https://acme.sh/)\n\n[![Cirle CI][cirle-ci-badge]][cirle-ci-url]\n[![Tested Ubuntu version][ubuntu-xenial-badge]][ubuntu-xenial-url]\n[![Tested Ubuntu version][ubuntu-badge]][ubuntu-url]\n[![Tested Centos version][centos-badge]][centos-url]\n\n\u003e :innocent: A :star: from you will make my day full of happiness :innocent:\n\n## Table of contents\n\n1. [Installation](#installation)\n2. [Usage](#usage)\n3. [Cloud integration](#cloud-integration)\n   - [AWS ACM](#aws-acm)\n   - [AWS IAM](#aws-iam)\n   - [Google Cloud](#google-cloud)\n4. [Automate renewal](#automate-renewal)\n   - [Renewal without cloud](#renewal-without-cloud)\n   - [Renewal with cloud](#renewal-with-cloud)\n5. [Local servers integration](#local-servers-integration)\n6. [Contribution](#contribution)\n7. [License](#license)\n\n## Installation\n\nUsing the installer\n\n```bash\ncurl -s -L  https://raw.githubusercontent.com/tekuasia/autossl/master/bin/installer.sh | sudo bash\n```\n\n## Usage\n\nAll commands can be listed using `autossl help`:\n\n![Screenshot][screenshot]\n\nTo generate free SSL certificate for a domain\n\n```bash\nautossl email@example.com example.com\n```\n\nTo generate free SSL certificate for wildcard domains\n\n```bash\nautossl email@example.com example.com *.example.com *.tld.example.com\n```\n\nTo automatically renew all certificates\n\n```bash\nautossl renew\n```\n\n## Cloud integration\n\n### AWS ACM\n\nWe need to prepare an AWS user with these permissions:\n\n- acm:ImportCertificates\n- acm:DescribeCertificate\n- acm:ListCertificates\n\nTo synchronize your certificates to AWS ACM\n\n```bash\nautossl sync acm\n```\n\n### AWS IAM\n\nWe need to prepare an AWS user with these permissions:\n\n- iam:UploadServerCertificate\n\nTo synchronize your certificates to AWS IAM\n\n```bash\nautossl sync iam\n```\n\n**Please note:** Your certificates will be saved into IAM as `\u003cdomain-names\u003e-YYYY-MM`. For example, you synchronize certificate for example\u0026#46;com in June 2019, it will be named as `example-com-2019-06`\n\n### Google Cloud\n\nWe need to enable cloud compute engine at [https://console.developers.google.com/apis/api/compute.googleapis.com](https://console.developers.google.com/apis/api/compute.googleapis.com)\n\nTo synchronize your certificates to Google Cloud\n\n```bash\nautossl sync gcloud\n```\n\n**Please note:** Your certificates will be saved into Gcloud as `\u003cdomain-names\u003e-YYYY-MM`. For example, you synchronize certificate for example\u0026#46;com in June 2019, it will be named as `example-com-2019-06`\n\n## Automate renewal\n\n### Renewal without cloud\n\n\u003e We suggest you to setup cronjob for automatically check expiration of certifcates everyday (There could be other approaches)\n\n```bash\ncrontab –e\n```\n\nThen add this line to make renewal automated everyday at 3:00\n\n```\n00 03 * * * autossl renew\n```\n\n### Renewal with cloud\n\n\u003e We suggest you to setup cronjob for automatically check expiration of certifcates everyday (There could be other approaches)\n\n[Optional] Init AWS for the first time if you are using AWS to manage SSL\n\n```bash\nautossl init-aws\n```\n\n[Optional] Init Google Cloud for the first time if you are using Google Cloud to manage SSL\n\n```bash\nautossl init-gcloud\n```\n\nOpen crontab editor\n\n```bash\ncrontab –e\n```\n\nThen add this line to make renewal automated and renewed certificates synced to cloud provider automatically everyday at 3:00\n\n```\n00 03 * * * autossl sync \u003cprovider\u003e \"$(autossl renew -d)\"\n```\n\n## Local servers integration\n\nHere are some helpful references for local servers integration instruction:\n\nFor nginx: [https://gist.github.com/nrollr/9a39bb636a820fb97eec2ed85e473d38](https://gist.github.com/nrollr/9a39bb636a820fb97eec2ed85e473d38)\n\nFor Apache: [https://techmonger.github.io/50/certbot-apache-configuration/](https://techmonger.github.io/50/certbot-apache-configuration/)\n\n## Contribution\n\nEveryone deserves free SSL certificates and free security. This tool was born for that purpose: Make it easier for people to get free SSL certificates. I really need your help to make this tool better.\n\nIf you want to help me, please fork this repository, make your changes and give me a pull request.\n\nThank you :)\n\n## License\n\nThese code are licensed under MIT License. You are free to use any parts of it.\n\n_KEEP CALM AND CODE ON :beers:_\n\n[cirle-ci-badge]: https://circleci.com/gh/tekuasia/autossl/tree/master.svg?style=shield\n[cirle-ci-url]: https://circleci.com/gh/tekuasia/autossl/tree/master\n[screenshot]: others/screenshot.png?raw=true\n[ubuntu-badge]: https://img.shields.io/badge/ubuntu-18.04-green.svg\n[ubuntu-url]: https://wiki.ubuntu.com/Releases\n[ubuntu-xenial-badge]: https://img.shields.io/badge/ubuntu-16.04-green.svg\n[ubuntu-xenial-url]: https://wiki.ubuntu.com/Releases\n[centos-badge]: https://img.shields.io/badge/centos-7.0-green.svg\n[centos-url]: https://www.centos.org/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabxvn%2Fautossl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabxvn%2Fautossl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabxvn%2Fautossl/lists"}