[{"_1":2,"_198":-5,"_199":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_170":171},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_163":-5,"_164":11,"_165":17,"_166":11,"_167":-5,"_168":169},"canonicalUrl","https://hub.docker.com/r/qmcgaw/srv/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","qmcgaw","reponame","srv","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2021-06-06T17:03:20.718603Z","description","SHORT_DESCRIPTION","is_private","last_updated","2021-06-27T16:55:07.964909Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.distribution.manifest.list.v2+json","name","pull_count",2732,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# SRV\r\n\r\n*srv is a small Go application to use as a container or as a base Docker image in other projects to serve static files over HTTP*\r\n\r\n

\r\n\r\n[![Build status](https://github.com/qdm12/srv/workflows/CI/badge.svg)](https://github.com/qdm12/srv/actions?query=workflow%3ACI)\r\n[![Docker Pulls](https://img.shields.io/docker/pulls/qmcgaw/srv.svg)](https://hub.docker.com/r/qmcgaw/srv)\r\n[![Docker Stars](https://img.shields.io/docker/stars/qmcgaw/srv.svg)](https://hub.docker.com/r/qmcgaw/srv)\r\n[![Image size](https://images.microbadger.com/badges/image/qmcgaw/srv.svg)](https://microbadger.com/images/qmcgaw/srv)\r\n[![Image version](https://images.microbadger.com/badges/version/qmcgaw/srv.svg)](https://microbadger.com/images/qmcgaw/srv)\r\n\r\n[![Join Slack channel](https://img.shields.io/badge/slack-@qdm12-yellow.svg?logo=slack)](https://join.slack.com/t/qdm12/shared_invite/enQtOTE0NjcxNTM1ODc5LTYyZmVlOTM3MGI4ZWU0YmJkMjUxNmQ4ODQ2OTAwYzMxMTlhY2Q1MWQyOWUyNjc2ODliNjFjMDUxNWNmNzk5MDk)\r\n[![GitHub last commit](https://img.shields.io/github/last-commit/qdm12/srv.svg)](https://github.com/qdm12/srv/commits/main)\r\n[![GitHub commit activity](https://img.shields.io/github/commit-activity/y/qdm12/srv.svg)](https://github.com/qdm12/srv/graphs/contributors)\r\n[![GitHub issues](https://img.shields.io/github/issues/qdm12/srv.svg)](https://github.com/qdm12/srv/issues)\r\n\r\n## Features\r\n\r\n- Compatible with `amd64`, `386`, `arm64`, `arm32v7`, `arm32v6`, `ppc64le`, `s390x` and `riscv64` CPU architectures\r\n- Runs without root as user ID `1000`\r\n- Based on the `scratch` docker image for a tiny size of 9.11MB (uncompressed amd64 image)\r\n- [Docker image tags and sizes](https://hub.docker.com/r/qmcgaw/srv/tags)\r\n- Prometheus metrics available on `:9091`\r\n\r\n## Setup\r\n\r\n### As a container\r\n\r\nWe assume your static files are at `/yourpath` on your host.\r\n\r\n1. Ensure the ownership of your static files matches the ones from the container:\r\n\r\n ```sh\r\n chown -R 1000 /yourpath\r\n ```\r\n\r\n1. Run the container, bind mounting `/yourpath` to `/srv` as ready only:\r\n\r\n ```sh\r\n docker run -d -p 8000:8000/tcp -v /yourpath:/srv:ro qmcgaw/srv\r\n ```\r\n\r\n You can also use [docker-compose.yml](https://github.com/qdm12/srv/blob/main/docker-compose.yml) with:\r\n\r\n ```sh\r\n docker-compose up -d\r\n ```\r\n\r\n1. You can update the image with `docker pull qmcgaw/srv` or use one of the [tags available](https://hub.docker.com/r/qmcgaw/srv/tags)\r\n\r\n### As a base image\r\n\r\nYou can use it in your own project with:\r\n\r\n```Dockerfile\r\nFROM qmcgaw/srv\r\nCOPY --chown=1000 srv /srv\r\n```\r\n\r\nOr with a multi stage Dockerfile:\r\n\r\n```Dockerfile\r\nFROM someimage AS staticbuilder\r\nCOPY . .\r\nRUN somecompiler --output-to=/tmp/build\r\n\r\nFROM qmcgaw/srv\r\nCOPY --from=staticbuilder --chown=1000 /tmp/build /srv\r\n```\r\n\r\n### Environment variables\r\n\r\n| Environment variable | Default | Possible values | Description |\r\n| --- | --- | --- | --- |\r\n| `HTTP_SERVER_ADDRESS` | `:8000` | Valid address | HTTP server listening address |\r\n| `HTTP_SERVER_ROOT_URL` | `/` | URL path | HTTP server root URL |\r\n| `HTTP_SERVER_LOG_REQUESTS` | `on` | `on` or `off` | Log requests and responses information |\r\n| `FILEPATH_SRV` | `/srv` | Valid file path | File path to your static files directory |\r\n| `METRICS_SERVER_ADDRESS` | `:9090` | Valid address | Prometheus HTTP server listening address |\r\n| `LOG_LEVEL` | `info` | `debug`, `info`, `warning`, `error` | Logging level |\r\n| `HEALTH_SERVER_ADDRESS` | `127.0.0.1:9999` | Valid address | Health server listening address |\r\n| `TZ` | `America/Montreal` | *string* | Timezone |\r\n\r\n## Development\r\n\r\n1. Setup your environment\r\n\r\n

Using VSCode and Docker (easier)

\r\n\r\n 1. Install [Docker](https://docs.docker.com/install/)\r\n - On Windows, share a drive with Docker Desktop and have the project on that partition\r\n - On OSX, share your project directory with Docker Desktop\r\n 1. With [Visual Studio Code](https://code.visualstudio.com/download), install the [remote containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)\r\n 1. In Visual Studio Code, press on `F1` and select `Remote-Containers: Open Folder in Container...`\r\n 1. Your dev environment is ready to go!... and it's running in a container :+1: So you can discard it and update it easily!\r\n\r\n

\r\n\r\n

Locally

\r\n\r\n 1. Install [Go](https://golang.org/dl/), [Docker](https://www.docker.com/products/docker-desktop) and [Git](https://git-scm.com/downloads)\r\n 1. Install Go dependencies with\r\n\r\n ```sh\r\n go mod download\r\n ```\r\n\r\n 1. Install [golangci-lint](https://github.com/golangci/golangci-lint#install)\r\n 1. You might want to use an editor such as [Visual Studio Code](https://code.visualstudio.com/download) with the [Go extension](https://code.visualstudio.com/docs/languages/go). Working settings are already in [.vscode/settings.json](https://github.com/qdm12/srv/main/.vscode/settings.json).\r\n\r\n

\r\n\r\n1. Commands available:\r\n\r\n ```sh\r\n # Build the binary\r\n go build cmd/app/main.go\r\n # Test the code\r\n go test ./...\r\n # Lint the code\r\n golangci-lint run\r\n # Build the Docker image\r\n docker build -t qmcgaw/srv .\r\n ```\r\n\r\n1. See [Contributing](https://github.com/qdm12/srv/main/.github/CONTRIBUTING.md) for more information on how to contribute to this repository.\r\n\r\n## License\r\n\r\nThis repository is under an [MIT license](https://github.com/qdm12/srv/main/license) unless otherwise indicated\r\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",230230344,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":152,"_153":90,"_154":29,"_155":52,"_53":156,"_157":158,"_159":150,"_160":152,"_161":62,"_162":17},"content_type","creator",2673644,"full_size",3389539,"id",152854433,"images",[97,114,120,125,130,135,141,147],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},"architecture","amd64","digest","sha256:d39c1d2b2fa79e06415dcdf1f79e62183f751d65d705f3951e3cd1d39867598b","features","","last_pulled","2026-09-20T01:17:34.278503437Z","last_pushed","2021-06-27T16:55:06Z","os","linux","os_features","os_version","size","variant",{"_98":115,"_100":116,"_102":103,"_104":117,"_106":118,"_108":109,"_110":103,"_111":-5,"_112":119,"_59":62,"_113":-5},"ppc64le","sha256:77b28bdc2ccc5c86780c5ca4e1b4989c026a57869ea7538ccc6917e2634f7af2","2026-09-20T01:17:34.327333985Z","2021-06-27T16:55:05Z",2987295,{"_98":121,"_100":122,"_102":103,"_104":123,"_106":118,"_108":109,"_110":103,"_111":-5,"_112":124,"_59":62,"_113":-5},"arm64","sha256:ea7bd3c5f383478d3416869ba2759da67e84bb6ec45a6c2c2fb613803e388099","2026-09-20T01:17:34.288316499Z",3085626,{"_98":126,"_100":127,"_102":103,"_104":128,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":129,"_59":62,"_113":-5},"386","sha256:9efcbd64e91d19901b5c85c6ddaf34cde15a118602742a17ae72f98190a4a574","2026-09-20T01:17:34.503684024Z",3230932,{"_98":131,"_100":132,"_102":103,"_104":133,"_106":118,"_108":109,"_110":103,"_111":-5,"_112":134,"_59":62,"_113":-5},"s390x","sha256:8d3eaa77a3d105cf434372118e4378524acaaaa563d08c7205f289d6266b2cc8","2026-09-20T01:17:34.422612304Z",3260269,{"_98":136,"_100":137,"_102":103,"_104":138,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":139,"_59":62,"_113":140},"arm","sha256:487ce31e7fdae8655fe952fc7b11e41a0877e3b0757af88712bd197b87d2d57c","2026-09-20T01:17:34.29262152Z",3169456,"v7",{"_98":136,"_100":142,"_102":103,"_104":143,"_106":144,"_108":109,"_110":103,"_111":-5,"_112":145,"_59":62,"_113":146},"sha256:97ea23975a7620be5eb4d28fd1a5583dd7f4705b979f7b8e09c8a829aec259b4","2026-09-20T01:17:34.429418695Z","2021-06-27T16:55:07Z",3173308,"v6",{"_98":148,"_100":149,"_102":103,"_104":150,"_106":144,"_108":109,"_110":103,"_111":-5,"_112":151,"_59":62,"_113":-5},"riscv64","sha256:154147626152f95622062a93b9f602436c22b969451d7957c0a2864cd4ade6dd","2026-09-20T01:17:34.539915271Z",3309983,"2021-06-27T16:55:07.022776Z","last_updater","last_updater_username","media_type","latest","repository",14299941,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":172,"_179":180,"_168":196,"_197":11},{"_36":173,"_38":174,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":175,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":176,"_75":11,"_76":178,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":177},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_181":60,"_182":-5,"_183":-5,"_184":185},"count","next","previous","results",[186],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":187,"_46":152,"_153":90,"_154":29,"_155":52,"_53":156,"_157":158,"_159":150,"_160":152,"_161":62,"_162":17},[188,189,190,191,192,193,194,195],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},{"_98":115,"_100":116,"_102":103,"_104":117,"_106":118,"_108":109,"_110":103,"_111":-5,"_112":119,"_59":62,"_113":-5},{"_98":121,"_100":122,"_102":103,"_104":123,"_106":118,"_108":109,"_110":103,"_111":-5,"_112":124,"_59":62,"_113":-5},{"_98":126,"_100":127,"_102":103,"_104":128,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":129,"_59":62,"_113":-5},{"_98":131,"_100":132,"_102":103,"_104":133,"_106":118,"_108":109,"_110":103,"_111":-5,"_112":134,"_59":62,"_113":-5},{"_98":136,"_100":137,"_102":103,"_104":138,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":139,"_59":62,"_113":140},{"_98":136,"_100":142,"_102":103,"_104":143,"_106":144,"_108":109,"_110":103,"_111":-5,"_112":145,"_59":62,"_113":146},{"_98":148,"_100":149,"_102":103,"_104":150,"_106":144,"_108":109,"_110":103,"_111":-5,"_112":151,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
9efcbd64e91d	linux/386	3.08 MB
d39c1d2b2fa7	linux/amd64	3.23 MB
97ea23975a76	linux/arm/v6	3.03 MB

qmcgaw/srv

Tags for qmcgaw/srv