{"id":15324538,"url":"https://github.com/mrinjamul/simple-web-server","last_synced_at":"2026-01-03T02:09:27.304Z","repository":{"id":42520619,"uuid":"347719184","full_name":"mrinjamul/simple-web-server","owner":"mrinjamul","description":"A simple (static) web server","archived":false,"fork":false,"pushed_at":"2022-04-01T19:21:43.000Z","size":33,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-26T07:35:50.390Z","etag":null,"topics":["certificate","golang","ssl-support","webserver"],"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/mrinjamul.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-03-14T18:26:54.000Z","updated_at":"2022-04-01T19:32:31.000Z","dependencies_parsed_at":"2022-09-21T19:51:41.344Z","dependency_job_id":null,"html_url":"https://github.com/mrinjamul/simple-web-server","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrinjamul%2Fsimple-web-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrinjamul%2Fsimple-web-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrinjamul%2Fsimple-web-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrinjamul%2Fsimple-web-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrinjamul","download_url":"https://codeload.github.com/mrinjamul/simple-web-server/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243806033,"owners_count":20350775,"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":["certificate","golang","ssl-support","webserver"],"created_at":"2024-10-01T09:27:08.767Z","updated_at":"2026-01-03T02:09:27.242Z","avatar_url":"https://github.com/mrinjamul.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# simple web server\n\nA simple (static) web server written in golang\n\n## Build and Run\n\nInstall by go,\n\n```sh\ngo get github.com/mrinjamul/simple-web-server\n\n```\n\nRunning with port 8081 and current directory,\n\n```sh\nsimple-web-server -p 8081 -d \"./\" # port and directory optional\n```\n\nRunning over HTTPS requires openssl key and openssl certificate to run.\n\nyou can download demo (key+certificate) from release section or generate with name `server.key` and `server.crt`.\n\nTo generate key and certificate,\n\n```sh\n$ openssl genrsa -out server.key 2048\n$ openssl ecparam -genkey -name secp384r1 -out server.key\n$ openssl req -new -x509 -sha256 -key server.key -out server.crt -days 3650\n```\n\nRunning over HTTPS,\n\n```sh\nsimple-web-server -d \"./\" --https -p 8443 -key \"server.key\" --cert \"server.crt\" # port and directory optional\n```\n\n## Docker\n\n### Instant Run\n\n```shell\ndocker run --rm -d -p 8080:8080 --name myawesomeapp -v \"$PWD\":/home/app mrinjamul/sws:latest\n```\n\n### Dockerfile\n\n```yml\n# Dockerfile\nFROM mrinjamul/sws:latest\n\nWORKDIR /home/app\n\nADD . /home/app\n\nCOPY sws.json /etc/sws/config.json\n\nCMD [\"sws\"]\n```\n\n### docker-compose\n\n```yml\n#docker-compose.yml\nversion: \"3\"\n\nservices:\n  sws:\n    container_name: sws\n    restart: always\n    image: mrinjamul/sws:latest\n    ports:\n      - \"8080:8080\"\n    volumes:\n      - \".:/home/app\"\n```\n\n## Some defaults\n\n- default port 8080 for http\n- default port 443 for https (may require root to run)\n- defualt directory \"./\"\n\n## Usage\n\n    Usage: simple-web-server [options]\n    Options:\n    -C, --cert string   openssl cert location for HTTPS\n    -d, --dir string    directory to serve\n    -h, --help          help message\n    -S, --https         serve over HTTPS\n    -k, --key string    openssl key location for HTTPS\n    -p, --port string   set port to serve\n    -v, --version       print version\n\n## License\n\n- licensed under MIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrinjamul%2Fsimple-web-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrinjamul%2Fsimple-web-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrinjamul%2Fsimple-web-server/lists"}