{"id":37164717,"url":"https://github.com/zhexuany/caddy","last_synced_at":"2026-01-14T19:33:33.265Z","repository":{"id":57595443,"uuid":"76675970","full_name":"zhexuany/caddy","owner":"zhexuany","description":"Fast, cross-platform HTTP/2 web server with automatic HTTPS","archived":false,"fork":true,"pushed_at":"2016-12-15T14:19:56.000Z","size":2369,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-06-20T08:00:12.860Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://caddyserver.com","language":"Go","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"caddyserver/caddy","license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zhexuany.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-12-16T18:23:49.000Z","updated_at":"2019-07-02T18:52:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zhexuany/caddy","commit_stats":null,"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/zhexuany/caddy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhexuany%2Fcaddy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhexuany%2Fcaddy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhexuany%2Fcaddy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhexuany%2Fcaddy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zhexuany","download_url":"https://codeload.github.com/zhexuany/caddy/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhexuany%2Fcaddy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28432628,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T18:57:19.464Z","status":"ssl_error","status_checked_at":"2026-01-14T18:52:48.501Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-01-14T19:33:32.505Z","updated_at":"2026-01-14T19:33:33.239Z","avatar_url":"https://github.com/zhexuany.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca href=\"https://caddyserver.com\"\u003e\u003cimg src=\"https://caddyserver.com/resources/images/caddy-lower.png\" alt=\"Caddy\" width=\"350\"\u003e\u003c/a\u003e\n\n[![community](https://img.shields.io/badge/community-forum-ff69b4.svg?style=flat-square)](https://forum.caddyserver.com) [![twitter](https://img.shields.io/badge/twitter-@caddyserver-55acee.svg?style=flat-square)](https://twitter.com/caddyserver) [![Documentation](https://img.shields.io/badge/godoc-reference-blue.svg?style=flat-square)](https://godoc.org/github.com/mholt/caddy) [![Linux Build Status](https://img.shields.io/travis/mholt/caddy.svg?style=flat-square\u0026label=linux+build)](https://travis-ci.org/mholt/caddy) [![Windows Build Status](https://img.shields.io/appveyor/ci/mholt/caddy.svg?style=flat-square\u0026label=windows+build)](https://ci.appveyor.com/project/mholt/caddy)\n[![Go Report Card](https://goreportcard.com/badge/github.com/mholt/caddy?style=flat-square)](https://goreportcard.com/report/mholt/caddy)\n\n\nCaddy is a general-purpose web server for Windows, Mac, Linux, BSD, and\n[Android](https://github.com/mholt/caddy/wiki/Running-Caddy-on-Android). It is\na capable but easier alternative to other popular web servers.\n\n[Releases](https://github.com/mholt/caddy/releases) ·\n[User Guide](https://caddyserver.com/docs) ·\n[Community](https://forum.caddyserver.com)\n\nTry browsing [the code on Sourcegraph](https://sourcegraph.com/github.com/mholt/caddy)!\n\n## Menu\n\n- [Features](#features)\n- [Quick Start](#quick-start)\n- [Running from Source](#running-from-source)\n- [Running in Production](#running-in-production)\n- [Contributing](#contributing)\n- [About the Project](#about-the-project)\n\n\n\n## Features\n\n- **Easy configuration** with Caddyfile\n- **Automatic HTTPS** via [Let's Encrypt](https://letsencrypt.org); Caddy\nobtains and manages all cryptographic assets for you\n- **HTTP/2** enabled by default (powered by Go standard library)\n- **Virtual hosting** for hundreds of sites per server instance, including TLS\nSNI\n- Experimental **QUIC support** for those that like speed\n- TLS session ticket **key rotation** for more secure connections\n- **Brilliant extensibility** so Caddy can be customized for your needs\n- **Runs anywhere** with **no external dependencies** (not even libc)\n\n\n\n## Quick Start\n\nCaddy binaries have no dependencies and are available for every platform.\nInstall Caddy any one of these ways:\n\n- **[Download page](https://caddyserver.com/download)** allows you to\ncustomize your build in the browser\n- **[Latest release](https://github.com/mholt/caddy/releases/latest)** for\npre-built binaries\n- **curl [getcaddy.com](https://getcaddy.com)** for auto install:\n`curl https://getcaddy.com | bash`\n\nOnce `caddy` is in your PATH, you can `cd` to your website's folder and run\n`caddy` to serve it. By default, Caddy serves the current directory at\n[localhost:2015](http://localhost:2015).\n\nTo customize how your site is served, create a file named Caddyfile by your\nsite and paste this into it:\n\n```plain\nlocalhost\n\ngzip\nbrowse\nwebsocket /echo cat\next    .html\nlog    /var/log/access.log\nproxy  /api 127.0.0.1:7005\nheader /api Access-Control-Allow-Origin *\n```\n\nWhen you run `caddy` in that directory, it will automatically find and use\nthat Caddyfile to configure itself.\n\nThis simple file enables compression, allows directory browsing (for folders\nwithout an index file), hosts a WebSocket echo server at /echo, serves clean\nURLs, logs requests to access.log, proxies all API requests to a backend on\nport 7005, and adds the coveted  `Access-Control-Allow-Origin: *` header for\nall responses from the API.\n\nWow! Caddy can do a lot with just a few lines.\n\nTo host multiple sites and do more with the Caddyfile, please see the\n[Caddyfile documentation](https://caddyserver.com/docs/caddyfile).\n\nNote that production sites are served over\n[HTTPS by default](https://caddyserver.com/docs/automatic-https).\n\nCaddy has a command line interface. Run `caddy -h` to view basic help or see\nthe [CLI documentation](https://caddyserver.com/docs/cli) for details.\n\n**Running as root:** We advise against this. You can still listen on ports\n\u003c 1024 using setcap like so: `sudo setcap cap_net_bind_service=+ep ./caddy`\n\n\n\n## Running from Source\n\nNote: You will need **[Go 1.7](https://golang.org/dl/)** or newer.\n\n1. `go get github.com/mholt/caddy/caddy`\n2. `cd` into your website's directory\n3. Run `caddy` (assuming `$GOPATH/bin` is in your `$PATH`)\n\nCaddy's `main()` is in the caddy subfolder. To recompile Caddy, use\n`build.bash` found in that folder.\n\n\n\n## Running in Production\n\nThe Caddy project does not officially maintain any system-specific\nintegrations, but your download file includes\n[unofficial resources](https://github.com/mholt/caddy/tree/master/dist/init)\ncontributed by the community that you may find helpful for running Caddy in\nproduction.\n\nHow you choose to run Caddy is up to you. Many users are satisfied with\n`nohup caddy \u0026`. Others use `screen`. Users who need Caddy to come back up\nafter reboots either do so in the script that caused the reboot, add a command\nto an init script, or configure a service with their OS.\n\n\n\n## Contributing\n\n**[Join our community](https://forum.caddyserver.com) where you can chat with\nother Caddy users and developers!**\n\nPlease see our [contributing guidelines](https://github.com/mholt/caddy/blob/master/CONTRIBUTING.md)\nand check out the [developer wiki](https://github.com/mholt/caddy/wiki).\n\nWe use GitHub issues and pull requests only for discussing bug reports and\nthe development of specific changes. We welcome all other topics on the\n[forum](https://forum.caddyserver.com)!\n\nIf you want to contribute to the documentation, please submit pull requests to [caddyserver/caddyserver.com](https://github.com/caddyserver/caddyserver.com).\n\nThanks for making Caddy -- and the Web -- better!\n\nSpecial thanks to\n[![DigitalOcean](https://i.imgur.com/sfGr0eY.png)](https://www.digitalocean.com)\nfor hosting the Caddy project.\n\n\n\n## About the Project\n\nCaddy was born out of the need for a \"batteries-included\" web server that runs\nanywhere and doesn't have to take its configuration with it. Caddy took\ninspiration from [spark](https://github.com/rif/spark),\n[nginx](https://github.com/nginx/nginx), lighttpd,\n[Websocketd](https://github.com/joewalnes/websocketd)\nand [Vagrant](https://www.vagrantup.com/),\nwhich provides a pleasant mixture of features from each of them.\n\n**The name \"Caddy\":** The name of the software is \"Caddy\", not \"Caddy Server\"\nor \"CaddyServer\". Please call it \"Caddy\" or, if you wish to clarify, \"the\nCaddy web server\". See [brand guidelines](https://caddyserver.com/brand).\n\n*Author on Twitter: [@mholt6](https://twitter.com/mholt6)*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhexuany%2Fcaddy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzhexuany%2Fcaddy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhexuany%2Fcaddy/lists"}