{"id":30612687,"url":"https://github.com/willtheorangeguy/nginx-file-directory","last_synced_at":"2025-08-30T05:35:14.851Z","repository":{"id":58154290,"uuid":"411501197","full_name":"willtheorangeguy/Nginx-File-Directory","owner":"willtheorangeguy","description":"The basic Nginx file directory page, as a simple HTML page.","archived":false,"fork":false,"pushed_at":"2025-08-14T21:33:31.000Z","size":277,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-14T23:24:10.835Z","etag":null,"topics":["directory","file","hacktoberfest","nginx","server"],"latest_commit_sha":null,"homepage":"https://willtheorangeguy.github.io/Nginx-File-Directory/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/willtheorangeguy.png","metadata":{"funding":{"github":["willtheorangeguy"],"custom":["https://paypal.me/wvdg44"]},"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-09-29T02:15:48.000Z","updated_at":"2025-08-14T21:33:27.000Z","dependencies_parsed_at":"2023-12-06T19:29:43.828Z","dependency_job_id":"d88f4378-033c-49bb-a161-d46961a0869b","html_url":"https://github.com/willtheorangeguy/Nginx-File-Directory","commit_stats":null,"previous_names":[],"tags_count":3,"template":true,"template_full_name":null,"purl":"pkg:github/willtheorangeguy/Nginx-File-Directory","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willtheorangeguy%2FNginx-File-Directory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willtheorangeguy%2FNginx-File-Directory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willtheorangeguy%2FNginx-File-Directory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willtheorangeguy%2FNginx-File-Directory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/willtheorangeguy","download_url":"https://codeload.github.com/willtheorangeguy/Nginx-File-Directory/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willtheorangeguy%2FNginx-File-Directory/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272808955,"owners_count":24996605,"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","status":"online","status_checked_at":"2025-08-30T02:00:09.474Z","response_time":77,"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":["directory","file","hacktoberfest","nginx","server"],"created_at":"2025-08-30T05:35:12.456Z","updated_at":"2025-08-30T05:35:14.827Z","avatar_url":"https://github.com/willtheorangeguy.png","language":"HTML","funding_links":["https://github.com/sponsors/willtheorangeguy","https://paypal.me/wvdg44","https://paypal.me/wvdg44?country.x=CA\u0026locale.x=en_US"],"categories":[],"sub_categories":[],"readme":"\u003c!-- Logo --\u003e\n\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/willtheorangeguy/Nginx-File-Directory/main/docs/images/logo.png\" height=\"250px\" alt=\"Nginx File Directory\"\u003e\n  \u003cbr\u003e\n  Nginx File Directory\n  \u003cbr\u003e\n\u003c/h1\u003e\n\n\u003c!-- Copy --\u003e\n\u003ch4 align=\"center\"\u003eThe basic Nginx file directory page, as a simple HTML page.\u003c/h4\u003e\n\n\u003c!-- Badges --\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003c!-- Stability --\u003e\n  \u003cimg alt=\"Docker State\" src=\"https://github.com/willtheorangeguy/Nginx-File-Directory/actions/workflows/docker-publish.yml/badge.svg\"\u003e\n  \u003c!-- Stability --\u003e\n  \u003cimg alt=\"GitHub Pages State\" src=\"https://github.com/willtheorangeguy/Nginx-File-Directory/actions/workflows/pages.yml/badge.svg\"\u003e\n  \u003c!-- Gitleaks --\u003e\n  \u003cimg alt=\"Gitleaks State\" src=\"https://github.com/willtheorangeguy/Nginx-File-Directory/actions/workflows/gitleaks.yml/badge.svg\"\u003e\n  \u003c!-- Version --\u003e\n  \u003cimg alt=\"GitHub Version\" src=\"https://img.shields.io/github/v/release/willtheorangeguy/Nginx-File-Directory\"\u003e\n  \u003c!-- Issues --\u003e\n  \u003cimg alt=\"GitHub Issues\" src=\"https://img.shields.io/github/issues/willtheorangeguy/Nginx-File-Directory\"\u003e\n  \u003c!-- Pull Requests --\u003e\n  \u003cimg alt=\"GitHub Pull Requests\" src=\"https://img.shields.io/github/issues-pr/willtheorangeguy/Nginx-File-Directory\"\u003e\n  \u003c!-- Discord --\u003e\n  \u003cimg alt=\"Discord Server ID\" src=\"https://img.shields.io/discord/962928811207430164\"\u003e\n  \u003c!-- Downloads --\u003e\n  \u003cimg alt=\"Downloads\" src=\"https://img.shields.io/github/downloads/willtheorangeguy/Nginx-File-Directory/total\"\u003e\n  \u003c!-- Language Count --\u003e\n  \u003cimg alt=\"GitHub Languages\" src=\"https://img.shields.io/github/languages/count/willtheorangeguy/Nginx-File-Directory\"\u003e\n\u003c/div\u003e\n\n\u003c!-- Navigation --\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#key-features\"\u003eKey Features\u003c/a\u003e •\n  \u003ca href=\"#download\"\u003eDownload\u003c/a\u003e •\n  \u003ca href=\"#how-to-use\"\u003eHow To Use\u003c/a\u003e •\n  \u003ca href=\"#support\"\u003eSupport\u003c/a\u003e •\n  \u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e •\n  \u003ca href=\"#changelog\"\u003eChangelog\u003c/a\u003e •\n  \u003ca href=\"#credits\"\u003eCredits \u0026 Contributors\u003c/a\u003e\n\u003c/p\u003e\n\n\u003c!-- Screenshot(s) --\u003e\n\n![screenshot](https://raw.githubusercontent.com/willtheorangeguy/Nginx-File-Directory/main/docs/images/welcome.png)\n\n## Key Features\n\n- Basic file directory view.\n- Name and upload date.\n- Folder and file links.\n- Compatible with all web servers and websites.\n- Cross platform.\n\n## Download\n\nYou can **[download](https://github.com/willtheorangeguy/Nginx-File-Directory/releases/latest) the source code** to modify the code and create your own file directory page.\n\nYou can also access the **production version the website**, available on all platforms, **[here](https://willtheorangeguy.github.io/Nginx-File-Directory/)**.\n\n## How To Use\n\nTo clone and run this website, you'll need [Git](https://git-scm.com/downloads) installed on your computer. If you would rather not use Git, you can just download the code from GitHub above. From your command line:\n\n```bash\n# Clone this repository\n$ git clone https://github.com/willtheorangeguy/Nginx-File-Directory.git\n\n# Go into the repository\n$ cd Nginx-File-Directory\n\n# Run the webpage\n$ index.html\n```\n\nYou can also pull the [Docker](https://www.docker.com/) image from GitHub Packages. From your command line:\n\n```bash\n# Pull image\n$ docker pull ghcr.io/willtheorangeguy/nginx-file-directory:main\n\n# Run container\n$ docker run -d -p 8000:80 ghcr.io/willtheorangeguy/nginx-file-directory:main\n\n# Now, navigate to localhost in your browser to see the webpage\n```\n\nHowever, **to make this your own directory**, follow the steps below:\n\n### Basics\n\n1. _Line 8_: Update the `directory` placeholder text between the `\u003ctitle\u003e...\u003c/title\u003e` tags with the actual directory name. This will be the title of the webpage.\n\n```html\n\u003chead\u003e\n  \u003ctitle\u003eIndex of /directory\u003c/title\u003e\n\u003c/head\u003e\n```\n\n2. _Line 10_: Update the `directory` placeholder text between the `\u003ch1\u003e...\u003c/h1\u003e` tags with the actual directory path. This will be the title displayed on the page.\n\n```html\n\u003ch1\u003eIndex of /directory\u003c/h1\u003e\n```\n\n3. _Line 13_: If this is a directory inside of another directory, remove the `\u003c!--` and `--\u003e` to uncomment the link to the directory above the current directory.\n\n```html\n\u003c!--\u003ca href=\"../\"\u003e../\u003c/a\u003e--\u003e\n```\n\n4. _Line 13_: If this is a directory inside of another directory, change the `../` between the `\u003ca\u003e...\u003c/a\u003e` tags with the actual link to the folder above.\n\n### For a File or Folder\n\n```html\n\u003ca href=\"folder/\"\u003efolder/\u003c/a\u003e MM-DD-YYYY HH:MM -\n```\n\n- Replace the `folder/` or `file/` link (between the `href=\"...\"` tag) with the actual link to the file or folder.\n- Replace the `folder/` or `file/` placeholder name (between the `\u003ca\u003e...\u003c/a\u003e` tags) with the real name of the file or folder.\n- Replace the `MM-DD-YYYY HH:MM` placeholder date with the date the file or folder was uploaded.\n- Add more of these rows as necessary.\n\n## Support\n\nFurther customization options for different types of files and folder structures can be found in [`CUSTOMIZATION`](https://github.com/willtheorangeguy/Nginx-File-Directory/blob/main/docs/CUSTOMIZATION.md). More documentation is available in the **[Documentation](https://github.com/willtheorangeguy/Nginx-File-Directory/tree/main/docs)** and on the **[Wiki](https://github.com/willtheorangeguy/Nginx-File-Directory/wiki)**. If more support is required, please open a **[GitHub Discussion](https://github.com/willtheorangeguy/Nginx-File-Directory/discussions/new)** or join our **[Discord](https://discord.gg/uQR9AfwBxU)**.\n\n## Contributing\n\nPlease contribute using [GitHub Flow](https://guides.github.com/introduction/flow). Create a branch, add commits, and [open a pull request](https://github.com/willtheorangeguy/Nginx-File-Directory/compare).\n\nPlease read [`CONTRIBUTING`](CONTRIBUTING.md) for details on our [`CODE OF CONDUCT`](CODE_OF_CONDUCT.md), and the process for submitting pull requests to us.\n\n## Changelog\n\nSee the [`CHANGELOG`](CHANGELOG.md) file for details.\n\n## Credits\n\nThis software uses the following open source packages, projects, services or websites:\n\n\u003c!-- Credits Table --\u003e\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003cth align=\"center\"\u003e\u003cimg src=\"https://applets.imgix.net/https%3A%2F%2Fassets.ifttt.com%2Fimages%2Fchannels%2F2107379463%2Ficons%2Fmonochrome_large.png?w=240\u0026h=240\u0026s=8a19bbc158996d098e2fb18310ba7f33\" width=\"150\" height=\"150\" alt=\"GitHub\"/\u003e\u003c/th\u003e\n    \u003cth align=\"center\"\u003e\u003cimg src=\"https://www.w3.org/assets/logos/w3c/w3c-no-bars.svg\" width=\"150\" height=\"150\" alt=\"W3C\"/\u003e\u003c/th\u003e\n    \u003cth align=\"center\"\u003e\u003cimg src=\"https://videos.w3schools.com/files/images/w3schools_logo_500_04AA6D.png\" width=\"150\" height=\"150\" alt=\"W3Schools\"/\u003e\u003c/th\u003e\n    \u003cth align=\"center\"\u003e\u003cimg src=\"https://www.logolynx.com/images/logolynx/06/0614238d6c1c151cf0f8201f4463cc8a.png\" width=\"150\" height=\"150\" alt=\"Nginx\"/\u003e\u003c/th\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003eGitHub\u003c/td\u003e\n    \u003ctd align=\"center\"\u003eW3C\u003c/td\u003e\n    \u003ctd align=\"center\"\u003eW3Schools\u003c/td\u003e\n    \u003ctd align=\"center\"\u003eNginx\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/\"\u003eWeb\u003c/a\u003e - \u003ca href=\"https://github.com/pricing\"\u003ePlans\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://www.w3.org\"\u003eWeb\u003c/a\u003e - \u003ca href=\"https://www.w3.org/support/\"\u003eDonate\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://www.w3schools.com\"\u003eWeb\u003c/a\u003e - \u003ca href=\"https://www.w3schools.com/pro/index.php\"\u003ePro\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://nginx.org/\"\u003eWeb\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## Contributors\n\n- [@willtheorangeguy](https://github.com/willtheorangeguy) - Sponsor on [PayPal](https://paypal.me/wvdg44?country.x=CA\u0026locale.x=en_US)\n\n## You may also like...\n\n- [Running Calculator](https://github.com/willtheorangeguy/Running-Calculator) - A running speed calculator for any unit of distance.\n- [PyWorkout](https://github.com/willtheorangeguy/PyWorkout) - A minimal CLI to keep you inspired during your workout! Easily used and customized, with support for multiple workout plans, different muscle groups and video workouts.\n- [PyAvatar](https://github.com/willtheorangeguy/PyAvatar) - Easily display all of your creative avatars to keep them consistent across websites.\n\n## License\n\n**The website code in this repository is created by the [Nginx Development Team](https://nginx.org/) and maintained by the Nginx Authors. The server is released under the BSD 3-Clause License, and this project follows those licensing guidelines.**\n\nThis project is licensed under the [BSD 2-Clause “Simplified” License](https://choosealicense.com/licenses/bsd-2-clause/) - see the [`LICENSE`](LICENSE.md) file for details. See the [Privacy Policy](https://github.com/willtheorangeguy/Nginx-File-Directory/blob/main/docs/legal/PRIVACY.md) and [Terms and Conditions](https://github.com/willtheorangeguy/Nginx-File-Directory/blob/main/docs/legal/TERMS.md) for legal information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwilltheorangeguy%2Fnginx-file-directory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwilltheorangeguy%2Fnginx-file-directory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwilltheorangeguy%2Fnginx-file-directory/lists"}