{"id":16895379,"url":"https://github.com/sundowndev/serve","last_synced_at":"2025-04-11T13:37:39.377Z","repository":{"id":64307715,"uuid":"260915422","full_name":"sundowndev/serve","owner":"sundowndev","description":"Simple, production ready, HTTP server for static file serving","archived":false,"fork":false,"pushed_at":"2023-04-01T09:52:32.000Z","size":47,"stargazers_count":10,"open_issues_count":4,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-25T09:52:47.091Z","etag":null,"topics":["http-server","production-ready","static-file","static-server"],"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/sundowndev.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-03T12:48:54.000Z","updated_at":"2025-03-17T18:33:38.000Z","dependencies_parsed_at":"2024-06-20T01:44:59.732Z","dependency_job_id":"73b3f04e-5655-485d-9103-21bde66af60a","html_url":"https://github.com/sundowndev/serve","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sundowndev%2Fserve","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sundowndev%2Fserve/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sundowndev%2Fserve/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sundowndev%2Fserve/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sundowndev","download_url":"https://codeload.github.com/sundowndev/serve/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248410314,"owners_count":21098775,"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":["http-server","production-ready","static-file","static-server"],"created_at":"2024-10-13T17:23:22.414Z","updated_at":"2025-04-11T13:37:39.349Z","avatar_url":"https://github.com/sundowndev.png","language":"Go","readme":"# serve\n\n![action](https://img.shields.io/endpoint.svg?url=https://actions-badge.atrox.dev/sundowndev/serve/badge?ref=master)\n[![Go Report Card](https://goreportcard.com/badge/github.com/sundowndev/serve)](https://goreportcard.com/report/github.com/sundowndev/serve)\n![release](https://img.shields.io/github/release/SundownDEV/serve.svg)\n\nLightweight, simple, production ready HTTP server for static file serving.\n\n## Installation\n\n```\n# Download the archive\n$ curl -L \"https://github.com/sundowndev/serve/releases/download/v1.1.0/serve_$(uname -s)_$(uname -m).tar.gz\" -o serve.tar.gz\n\n# Extract the binary\n$ tar xfv serve.tar.gz\n\n# Run the software\n$ ./serve -h\n\n# You can install it globally\n$ mv ./serve /usr/bin/serve\n```\n\nIf the installation fails, it probably means your OS/arch is not suppored.\n\nPlease check the output of echo \"$(uname -s)_$(uname -m)\" in your terminal and see if it's available on the [GitHub release page](https://github.com/sundowndev/serve/releases).\n\n## Usage\n\nHere's the help message :\n\n```\n$ serve -h\n\nUsage of http_server:\n  -addr string\n    \tThe address to listen to.\n  -port string\n    \tThe port to listen to.\n  -prefix string\n    \tThe URI prefix path.\n  -root string\n    \tthe directory to serve files from.\n```\n\nLaunch a HTTP server to serve files in the current directory :\n\n```\n$ serve -root . -port 8080 \n```\n\n### Docker image\n\nLaunch a HTTP server to serve files in the `public` directory :\n\n```\n$ docker run -it --rm -v $PWD/public:/app/public:ro -p 80:80 sundowndev/serve -root public\n```\n\n#### Using compose\n\n```yml\nversion: '3.7'\n\nservices:\n    serve:\n      container_name: serve\n      restart: on-failure\n      image: sundowndev/serve:latest\n      command: \"-root ./public\"\n      volumes:\n        - ./fixtures:/app/public:ro\n      ports:\n        - \"80:80\"\n```\n\n## License\n\nThis project is MIT Licensed.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsundowndev%2Fserve","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsundowndev%2Fserve","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsundowndev%2Fserve/lists"}