{"id":19020648,"url":"https://github.com/simeononsecurity/docker-hs20server","last_synced_at":"2026-06-21T15:31:56.980Z","repository":{"id":237459844,"uuid":"779846678","full_name":"simeononsecurity/docker-hs20server","owner":"simeononsecurity","description":"A Full HS20 OSU Server Setup in Docker using hostapd, HS20-Server, Radius, sqllite3, and apache","archived":false,"fork":false,"pushed_at":"2024-03-31T00:08:32.000Z","size":39,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-21T18:25:39.070Z","etag":null,"topics":["802-11","80211","eap-mschapv2","eap-tls","eap-ttls","hostapd","hotspot-wifi","osu","passpoint","radius","radius-server","wba","wi-fi"],"latest_commit_sha":null,"homepage":"https://simeononsecurity.com","language":"PHP","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/simeononsecurity.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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},"funding":{"github":["simeononsecurity"],"custom":["https://simeononsecurity.com","https://simeononsecurity.com/recommendhome","https://simeononsecurity.com/affiliate","https://twitter.com/simeonsecurity","https://discord.io/cybersentinels"]}},"created_at":"2024-03-31T00:08:30.000Z","updated_at":"2024-03-31T00:13:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"a4151dda-1ec1-4943-86df-ebb4a584bf32","html_url":"https://github.com/simeononsecurity/docker-hs20server","commit_stats":null,"previous_names":["simeononsecurity/docker-hs20server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/simeononsecurity/docker-hs20server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simeononsecurity%2Fdocker-hs20server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simeononsecurity%2Fdocker-hs20server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simeononsecurity%2Fdocker-hs20server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simeononsecurity%2Fdocker-hs20server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simeononsecurity","download_url":"https://codeload.github.com/simeononsecurity/docker-hs20server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simeononsecurity%2Fdocker-hs20server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34616509,"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-21T02:00:05.568Z","response_time":54,"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":["802-11","80211","eap-mschapv2","eap-tls","eap-ttls","hostapd","hotspot-wifi","osu","passpoint","radius","radius-server","wba","wi-fi"],"created_at":"2024-11-08T20:17:56.720Z","updated_at":"2026-06-21T15:31:56.964Z","avatar_url":"https://github.com/simeononsecurity.png","language":"PHP","funding_links":["https://github.com/sponsors/simeononsecurity","https://simeononsecurity.com","https://simeononsecurity.com/recommendhome","https://simeononsecurity.com/affiliate","https://twitter.com/simeonsecurity","https://discord.io/cybersentinels"],"categories":[],"sub_categories":[],"readme":"# Docker Hotspot 2.0 Server\n\nThis repository houses a Docker setup for a Hotspot 2.0 Online Sign-Up (OSU) server, tailored for experimental and testing environments. It leverages Ubuntu as the base system and incorporates services such as Apache2, hostapd, and a RADIUS server, pre-configured to align with the Hotspot 2.0 standards.\n\n**Note**: ***This Container is Completely Untested. Don't expect it to work just yet.***\n\n## Prerequisites\n\nEnsure Docker is installed on your machine. For installation guidance, consult the [official Docker documentation](https://docs.docker.com/get-docker/).\n\n## Quick Links\n\n- [Hostapd Development](https://w1.fi/hostapd/)\n- [HS20 Server Codebase](https://git.launchpad.net/ubuntu/+source/wpa/tree/hs20/server)\n- [HS20 OSU Server Install Instructions](https://git.launchpad.net/ubuntu/+source/wpa/tree/hs20/server/hs20-osu-server.txt)\n\n## Project Structure Overview\n\n- **Dockerfile**: Specifies the Docker container setup.\n- **entrypoint.sh**: Initialization script for container services.\n- **/ca**: Holds certificate authority files and scripts to help generate new ones.\n- **/config**: Configuration files for hostapd, Apache, and other services.\n- **/www**: Web server directory containing PHP scripts and HTML for OSU interaction.\n\n## Building the Container\n\nNavigate to the project's root directory and execute:\n\n```sh\ndocker build -t docker-hs20server .\n```\n\nThis command constructs the Docker image tagged as `docker-hs20server`.\n\n## Running the Container\n\nTo run the container:\n\n```sh\ndocker run -d -p 80:80 -p 443:443 --name hs20server docker-hs20server\n```\n\nThis starts the container in detached mode, binding ports 80 (HTTP) and 443 (HTTPS) to the host.\n\n## Custom Configuration and CA Generation\n\n### Hotspot 2.0 OSU Server Configuration\n\nThis setup assumes an Ubuntu server with Apache2. Adjust package names and configuration parameters if using other environments. Note: This setup is intended for lab use only and requires security modifications for public deployment.\n\n### Building and Configuring Services Manually (without Docker)\n\n1. **Install Dependencies**: Ensure your system has all required packages:\n   ```sh\n   sudo apt-get install sqlite3 apache2 php-sqlite3 php-xml libapache2-mod-php build-essential libsqlite3-dev libssl-dev libxml2-dev\n   ```\n2. **Setup Directory Structure**: Choose an installation directory, for example, `/home/user/hs20-server`, and set appropriate permissions.\n\n3. **Build hostapd and hs20_spp_server**: Follow build instructions specific to these services, ensuring all configurations align with your setup requirements.\n\n### CA Generation and Configuration\n\n1. **Initialize CA**: Navigate to the `ca` directory and utilize `setup.sh` to configure your CA, adjusting parameters to fit your hostname and requirements.\n\n2. **Configure Apache and PHP**: Update `/etc/apache2/sites-available/default-ssl` to utilize your server certificates and adjust PHP settings as necessary.\n\n### Linking to Source and Documentation\n\nFor further details on configuring and building `hostapd` and `hs20_spp_server`, visit the following resources:\n- [HS20 OSU Server Install Instructions](https://git.launchpad.net/ubuntu/+source/wpa/tree/hs20/server/hs20-osu-server.txt)\n- [HS20 Server Codebase](https://git.launchpad.net/ubuntu/+source/wpa/tree/hs20/server)\n- [Hostapd](https://w1.fi/hostapd/)\n\nEnsure to review these resources to align with the latest best practices and updates.\n\n## Access and Management\n\nThe management UI is accessible via `https://\u003cserver-address\u003e/hs20/users.php`. Replace `\u003cserver-address\u003e` with your actual server IP or hostname.\n\n## Contributing\n\nContributions to enhance this Docker Hotspot 2.0 server setup are welcomed. Please adhere to standard coding practices and submit pull requests for review.\n\n## License\n\n[LICENSE](/LICENSE)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimeononsecurity%2Fdocker-hs20server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimeononsecurity%2Fdocker-hs20server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimeononsecurity%2Fdocker-hs20server/lists"}