{"id":13563875,"url":"https://github.com/kevinpollet/serve","last_synced_at":"2025-12-15T05:06:45.940Z","repository":{"id":55674043,"uuid":"243220317","full_name":"kevinpollet/serve","owner":"kevinpollet","description":"Simple and secure Go HTTP server to serve static sites or files from the command-line.","archived":false,"fork":false,"pushed_at":"2022-01-09T17:03:46.000Z","size":2674,"stargazers_count":62,"open_issues_count":9,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-01T13:11:12.631Z","etag":null,"topics":["command-line","docker","files","go","http","server","static"],"latest_commit_sha":null,"homepage":"","language":"Go","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/kevinpollet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-02-26T09:15:28.000Z","updated_at":"2024-07-12T14:56:53.000Z","dependencies_parsed_at":"2022-08-15T06:10:39.301Z","dependency_job_id":null,"html_url":"https://github.com/kevinpollet/serve","commit_stats":null,"previous_names":["kevinpollet/srv"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinpollet%2Fserve","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinpollet%2Fserve/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinpollet%2Fserve/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinpollet%2Fserve/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kevinpollet","download_url":"https://codeload.github.com/kevinpollet/serve/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244181291,"owners_count":20411605,"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":["command-line","docker","files","go","http","server","static"],"created_at":"2024-08-01T13:01:24.186Z","updated_at":"2025-12-15T05:06:45.581Z","avatar_url":"https://github.com/kevinpollet.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# serve\n\n[![Build Status](https://github.com/kevinpollet/serve/workflows/build/badge.svg)](https://github.com/kevinpollet/serve/actions)\n\nSimple and secure [Go](https://go.dev/) `HTTP` server to serve static sites or files from the command-line.\n\n- HTTP/2 and TLS support.\n- Custom Error pages.\n- Basic HTTP authentication.\n- Hide dot files by default.\n- Directory listing is disabled by default.\n- Encoding negotiation with support of [gzip](https://www.gzip.org/), [Deflate](https://en.wikipedia.org/wiki/DEFLATE)\n  and [Brotli](https://en.wikipedia.org/wiki/Brotli) compression algorithms.\n\n## Installation\n\n```shell\ngo install github.com/kevinpollet/serve\n```\n\n## Usage\n\n```shell\nUsage: serve [options]\n\nOptions:\n-addr       Sets the server address. Default is \"127.0.0.1:8080\".\n-auth       Sets the basic auth credentials (password must be hashed with bcrypt and escaped with '').\n-auth-file  Sets the basic auth credentials following the \".htpasswd\" format.\n-dir        Sets the directory containing the files to serve. Default is \".\".\n-cert       Sets the TLS certificate.\n-key        Sets the TLS private key.\n-help       Prints this text.\n```\n\n### Docker\n\nA Docker [image](https://hub.docker.com/r/kevinpollet/serve) is available to serve static files from a running Docker\ncontainer. By default, all files located in the `/var/www/` directory will be made available through TCP connections on\nport `8080`. For more details, check out the Docker [example](./examples/docker).\n\n## Examples\n\n- [hello](./examples/hello) — Simple static site that can be served from the command-line.\n- [docker](./examples/docker) — Simple static site that can be served from a Docker container.\n\n## Contributing\n\nPRs welcome!\n\nWant to file a bug or request a feature?\n\n1. Check out the [Code of Conduct](./CODE_OF_CONDUCT.md).\n2. Check for an existing issue corresponding to your bug or feature request.\n3. Open an issue to describe your bug or feature request.\n\n## License\n\n[MIT](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinpollet%2Fserve","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkevinpollet%2Fserve","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinpollet%2Fserve/lists"}