{"id":19218210,"url":"https://github.com/greggman/servez","last_synced_at":"2026-03-08T08:02:38.052Z","repository":{"id":46586184,"uuid":"83831072","full_name":"greggman/servez","owner":"greggman","description":"A simple web server for local web development.","archived":false,"fork":false,"pushed_at":"2024-08-06T05:46:54.000Z","size":6177,"stargazers_count":307,"open_issues_count":8,"forks_count":48,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-03-30T09:07:40.401Z","etag":null,"topics":["server","webserver"],"latest_commit_sha":null,"homepage":"https://greggman.github.io/servez/","language":"JavaScript","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/greggman.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}},"created_at":"2017-03-03T18:57:34.000Z","updated_at":"2025-03-22T12:52:05.000Z","dependencies_parsed_at":"2024-07-14T07:43:07.715Z","dependency_job_id":"80e52e3f-185b-47f2-ad45-7c5adbbd2f6e","html_url":"https://github.com/greggman/servez","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greggman%2Fservez","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greggman%2Fservez/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greggman%2Fservez/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/greggman%2Fservez/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/greggman","download_url":"https://codeload.github.com/greggman/servez/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247464226,"owners_count":20942970,"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":["server","webserver"],"created_at":"2024-11-09T14:25:43.793Z","updated_at":"2026-03-08T08:02:33.031Z","avatar_url":"https://github.com/greggman.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Servez\n\n\u003cimg src=\"servez.jpg\" width=\"512px\" /\u003e\n\nA simple web server for local web development.\n\n![screenshow](servez.gif)\n\n## Download\n\n[Click Here](https://github.com/greggman/servez/releases/latest)\n\nChoose the `.dmg` for mac, the `.exe` for Windows, or the `.AppImage` for Linux.\n\n## What?\n\nServez is an stand alone app that runs a simple web server.\nwith a GUI to start/stop and choose a folder to serve.\n\nI've worked with many people, often students, who are not\ncomfortable with command lines and certainly not comfortable\nsetting up a big server like Apache.\n\nServez provides them with an easy way to get started without\nhaving to install multiple dependencies nor having to integrate\nthings with their system. No adding to paths, no downloading\n3 different pieces of software. Just run and start.\n\n## HTTPS\n\nServez has an option to serve HTTPS. Servez\nuses a self signed certificate which means your browser will complain\nthat the certificate is not valid. You can click \"advanced\" on the warning\npage and then \"Proceed to \u0026lt;localhost\u0026gt;\" to load the page.\n\nThe point of HTTPS support in Servez is to make it easy to access HTTPS only APIs\nlike WebXR etc... Clicking through a warning once in a while is a small tradeoff for\nautomating HTTPS support.\n\n## Command Line Arguments\n\nIf you want an actual command line version then [go here](https://github.com/greggman/servez-cli).\n\nOtherwise these are the command line arguments to this app version\nof Servez.\n\n**NOTE! You must include an extra `--` *by itself* before your arguments**\n\n```\nservez.exe --port=1234 c:\\path\\to\\serve      # BAD!\nservez.exe -- --port=1234 c:\\path\\to\\serve   # good\n```\n\nOn Windows the default path is\n\n```\nc:\\Users\\\u003cusername\u003e\\AppData\\Local\\Programs\\Servez\\Servez.exe\n```\n\non MacOS the default path is\n\n```\n/Applications/Servez.app/Contents/MacOS/Servez\n```\n\n### Usage\n\n```\nservez [options] path/to/serve\n```\n\n* `--help` prints the command line arguments\n\n* `-p` or `--port` sets the port as in `--port=1234`\n\n* `--ssl` use HTTPS (see above)\n\n* `--no-dirs` don't show directory listings for folders\n\n* `--no-cors` don't supply CORS headers\n\n* `--local` only allow access from local machine\n\n* `--no-index` don't serve index.html for folders\n\n## Development\n\n### Setup\n\n*   Install node.js\n\n    You can [download it here](https://nodejs.org).\n\n*   clone this repo\n\n        git clone https://github.com/greggman/servez.git\n\n*   change to the project's folder\n\n        cd servez\n\n*   install dependencies\n\n        npm install\n\n### Organization\n\n    main.js          // runs the browser process\n    src/index.html   // the main window\n    src/index.js     // JS for the main window\n    src/style.css    // CSS for the main window\n\n### Running\n\n    npm start\n\nWill launch with devtools open. Setting the environment variable `SERVEZ_ECHO`\nto `true` will make issue many logging commands in `main.js` into the log\nin the app\n\n### Building\n\n    npm run dist\n\nWill build a file for distribution in the `dist` folder for the current platform.\nNote: On MacOS you'll need an Apple Developer account. Then build like this\n\n```bash\nAPPLEID=\u003cyour-apple-id\u003e APPLEIDPASS=\u003csee-below-password\u003e npm run dist\n```\n\nFor `\u003cyour-apple-id\u003e` instead your Apple ID. Example `APPLEID=myaccount@gmail.com` or whatever your\nApple ID is.\n\nFor `\u003csee-below-password\u003e` the first step is go to [https://appleid.apple.com/](https://appleid.apple.com/)\nand generate an *app specific password*. Then, add that password to your keychain with an id of your choosing.\n\n```\nsecurity add-generic-password -a \"\u003cyour-apple-id\u003e\" -w \u003capp-specific-password\u003e -s \"\u003ckey-id\u003e\"\n```\n\nExample:\n\n```\nsecurity add-generic-password -a \"myaccount@gmail.com\" -w thea-pppa-sswo-rddd -s \"foobar\"\n```\n\nFrom then on, to build\n\n```\nAPPLEID=myaccount@gmail.com APPLEIDPASS=@keychain:foobar npm run dist\n```\n\nDuring the build it will ask you to give it access to 'foobar'","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreggman%2Fservez","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgreggman%2Fservez","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreggman%2Fservez/lists"}