{"id":50900747,"url":"https://github.com/kguzek/nginx-fancyindex-docker","last_synced_at":"2026-06-16T02:04:44.818Z","repository":{"id":364157892,"uuid":"1266665598","full_name":"kguzek/nginx-fancyindex-docker","owner":"kguzek","description":"A docker image for ngx-fancyindex","archived":false,"fork":false,"pushed_at":"2026-06-11T21:50:55.000Z","size":5,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-11T23:08:11.349Z","etag":null,"topics":["docker","fancyindex","nginx","ngx-fancyindex"],"latest_commit_sha":null,"homepage":"https://registry.guzek.uk/harbor/projects/3/repositories/nginx-fancyindex/artifacts-tab?publicAndNotLogged=yes","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kguzek.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-11T20:53:38.000Z","updated_at":"2026-06-11T21:51:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kguzek/nginx-fancyindex-docker","commit_stats":null,"previous_names":["kguzek/nginx-fancyindex-docker"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/kguzek/nginx-fancyindex-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kguzek%2Fnginx-fancyindex-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kguzek%2Fnginx-fancyindex-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kguzek%2Fnginx-fancyindex-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kguzek%2Fnginx-fancyindex-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kguzek","download_url":"https://codeload.github.com/kguzek/nginx-fancyindex-docker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kguzek%2Fnginx-fancyindex-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34387480,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-16T02:00:06.860Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["docker","fancyindex","nginx","ngx-fancyindex"],"created_at":"2026-06-16T02:04:43.902Z","updated_at":"2026-06-16T02:04:44.809Z","avatar_url":"https://github.com/kguzek.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# nginx-fancyindex-docker\n\nMinimal Docker image that builds nginx from source with [`ngx-fancyindex`](https://github.com/aperezdc/ngx-fancyindex) compiled in.\n\n## Usage\n\nThe image is available at [registry.guzek.uk/nginx/nginx-fancyindex](https://registry.guzek.uk/harbor/projects/3/repositories/nginx-fancyindex/artifacts-tab) and can be pulled without cloning this repository.\n\n### Run directly\n\n```sh\ndocker run --rm -p 8080:80 registry.guzek.uk/nginx/nginx-fancyindex\n```\n\nTo serve your own directory:\n\n```sh\ndocker run --rm -p 8080:80 \\\n  -v \"$PWD/html:/usr/share/nginx/html:ro\" \\\n  registry.guzek.uk/nginx/nginx-fancyindex\n```\n\nTo customize nginx directives without rebuilding the image, bind-mount `.conf` snippets into one of the included configuration directories:\n\n- `/etc/nginx/conf.d/*.conf` for directives inside the `http` block\n- `/etc/nginx/server.d/*.conf` for directives inside the default `server` block\n- `/etc/nginx/location.d/*.conf` for directives inside the default `/` location\n\nFor example, create `location.conf`:\n\n```nginx\nfancyindex_exact_size on;\nfancyindex_name_length 255;\n```\n\nThen run:\n\n```sh\ndocker run --rm -p 8080:80 \\\n  -v \"$PWD/html:/usr/share/nginx/html:ro\" \\\n  -v \"$PWD/location.conf:/etc/nginx/location.d/custom.conf:ro\" \\\n  registry.guzek.uk/nginx/nginx-fancyindex\n```\n\nYou can still replace the whole nginx configuration if needed:\n\n```sh\ndocker run --rm -p 8080:80 \\\n  -v \"$PWD/nginx.conf:/etc/nginx/nginx.conf:ro\" \\\n  registry.guzek.uk/nginx/nginx-fancyindex\n```\n\n### Run with Docker Compose\n\n```sh\nwget https://raw.githubusercontent.com/kguzek/nginx-fancyindex-docker/main/compose.yaml\nvi compose.yaml # modify the compose file to your liking\ndocker compose up -d\n```\n\nExample compose file with content and nginx directive snippets mounted:\n\n```yaml\nservices:\n  nginx-fancyindex:\n    image: registry.guzek.uk/nginx/nginx-fancyindex:latest\n    ports:\n      - \"8080:80\"\n    volumes:\n      - ./html:/usr/share/nginx/html:ro\n      - ./location.conf:/etc/nginx/location.d/custom.conf:ro\n```\n\n## Manual build\n\nClone this repository and enter the `nginx-fancyindex-docker` directory.\n\n```sh\ngit clone https://github.com/kguzek/nginx-fancyindex-docker\ncd nginx-fancyindex-docker\n```\n\nYou can now build the image manually.\n\n```sh\ndocker build -t nginx-fancyindex .\n```\n\nOptional build arguments:\n\n```sh\ndocker build \\\n  --build-arg NGINX_VERSION=1.26.3 \\\n  --build-arg FANCYINDEX_REF=master \\\n  -t nginx-fancyindex .\n```\n\n### Run built image\n\n```sh\ndocker run --rm -p 8080:80 nginx-fancyindex\n```\n\nOpen \u003chttp://localhost:8080\u003e.\n\nTo serve your own directory:\n\n```sh\ndocker run --rm -p 8080:80 \\\n  -v \"$PWD/html:/usr/share/nginx/html:ro\" \\\n  nginx-fancyindex\n```\n\nTo customize nginx directives without rebuilding again, use the same include directories as the hosted image:\n\n```sh\ndocker run --rm -p 8080:80 \\\n  -v \"$PWD/html:/usr/share/nginx/html:ro\" \\\n  -v \"$PWD/location.conf:/etc/nginx/location.d/custom.conf:ro\" \\\n  nginx-fancyindex\n```\n\nSnippet mounts are loaded from:\n\n- `/etc/nginx/conf.d/*.conf` inside the `http` block\n- `/etc/nginx/server.d/*.conf` inside the default `server` block\n- `/etc/nginx/location.d/*.conf` inside the default `/` location\n\n#### With Docker Compose\n\nReplace the `image` field in [compose.yaml](compose.yaml#L3) with `build`:\n\n```diff\n-    image: registry.guzek.uk/nginx/nginx-fancyindex:latest\n+    build: .\n```\n\nThis will now use the local Dockerfile instead of pulling the remote image.\n\n```sh\ndocker compose up --build\n```\n\nLocal compose usage can mount directive snippets in the same way:\n\n```yaml\nservices:\n  nginx-fancyindex:\n    build: .\n    ports:\n      - \"8080:80\"\n    volumes:\n      - ./html:/usr/share/nginx/html:ro\n      - ./location.conf:/etc/nginx/location.d/custom.conf:ro\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkguzek%2Fnginx-fancyindex-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkguzek%2Fnginx-fancyindex-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkguzek%2Fnginx-fancyindex-docker/lists"}