{"id":42653172,"url":"https://github.com/mrzack99s/coco-captive-portal","last_synced_at":"2026-01-29T07:43:34.690Z","repository":{"id":48278025,"uuid":"504760995","full_name":"mrzack99s/coco-captive-portal","owner":"mrzack99s","description":"CoCo Captive Portal is a network security application. it's extremely simple, lightning fast installer","archived":false,"fork":false,"pushed_at":"2022-10-17T05:38:31.000Z","size":20033,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-06-21T03:16:37.153Z","etag":null,"topics":["authen-server","authentication","captive-portal","hotspots","network-middleware","networking","wifi-hotspot"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mrzack99s.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}},"created_at":"2022-06-18T06:13:28.000Z","updated_at":"2024-06-21T03:16:37.153Z","dependencies_parsed_at":"2022-09-14T05:11:02.584Z","dependency_job_id":null,"html_url":"https://github.com/mrzack99s/coco-captive-portal","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/mrzack99s/coco-captive-portal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrzack99s%2Fcoco-captive-portal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrzack99s%2Fcoco-captive-portal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrzack99s%2Fcoco-captive-portal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrzack99s%2Fcoco-captive-portal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrzack99s","download_url":"https://codeload.github.com/mrzack99s/coco-captive-portal/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrzack99s%2Fcoco-captive-portal/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28870641,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-29T07:35:32.468Z","status":"ssl_error","status_checked_at":"2026-01-29T07:33:31.463Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["authen-server","authentication","captive-portal","hotspots","network-middleware","networking","wifi-hotspot"],"created_at":"2026-01-29T07:43:34.101Z","updated_at":"2026-01-29T07:43:34.672Z","avatar_url":"https://github.com/mrzack99s.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CoCo Captive Portal\n\nCoCo Captive Portal is a network security application. it's extremely simple, lightning fast installer.\n\n## Download\n\nPlease check the [releases](https://github.com/mrzack99s/coco-captive-portal/releases/) page.\n\n## Features\n\n- Captive Portal (L3)\n- LDAP Integration\n- Radius Integration\n- DDOS Prevention (Basic)\n\n## Requirements\n\n- NIC: 2 interfaces\n- CPU: Minumum require 2 physical cores (4 vCores)\n- Memory: Minumum require 2 GiB\n- OS\n  - Ubuntu: 18.04, 20.04\n  - Debian: 10, 11\n- IP Address of an interface and prepare routing table\n\n## Getting Started\n\n- Download CoCo Installer\n\n```bash\ncurl -L https://github.com/mrzack99s/coco-captive-portal/releases/latest/download/coco-installer -o coco-installer\n```\n\n- Grant it to be executable\n\n```bash\nsudo chmod +x coco-installer\n```\n\n- Install CoCo Captive Portal\n\n```bash\nsudo ./coco-installer up\n```\n\n\u003e Install with lastest version\n\n```bash\nsudo ./coco-installer up --latest\n```\n\n\u003e Install with ignore some verification\n\n```bash\nsudo ./coco-installer up --ignore\n```\n\n\u003e Uninstall CoCo Captive Portal\n\n```bash\nsudo ./coco-installer purge\n```\n\n## Certificates\n\n- Need a certificates in **_certs_** directory\n  - For Auth Endpoint\n    - **authfullchain.pem**\n    - **authprivkey.pem**\n  - For Auth Endpoint\n    - **operatorfullchain.pem**\n    - **operatorprivkey.pem**\n  - For LDAP (Optional)\n    - **ldapchain.pem**\n    - **ldapprivkey.pem**\n- to auto generate self-signed certificate\n\n```bash\n/var/coco-captive-portal/coco gencert\n```\n\n## API\n\n- API Token will store in file **_app_credentials.yaml_**\n- For renew api token\n\n```bash\n/var/coco-captive-portal/coco renew-api-token\n```\n\n- API Documents, open url to your endpoint then **/docs**\n  - Ex. https://coco-captive-portal.local/docs\n\n## Manual Install\n\n### Devtool Requirements\n\n- Make\n- gcc - build essential\n- Libpcap\n- Redis 7\n- Golang \u003e= 1.17.xx\n- NodeJS \u003e= 16.xx\n- Yarn\n\n```bash\ngit clone https://github.com/mrzack99s/coco-captive-portal\n\ncd coco-captive-portal\n\n# Install devtools and libs\nsudo make install-dev-tools\n\n# Build CoCo Captive Portal\nsudo make build\n\n# Build UI\nsudo make build-node\n\n# Create directory\nmkdir -p /var/coco-captive-portal\n\n# Copy\nsudo cp -r dist-auth-ui /var/coco-captive-portal\nsudo cp -r dist-operator-ui /var/coco-captive-portal\nsudo cp coco /var/coco-captive-portal\nsudo cp coco-captive-portal.service /etc/systemd/system\n\n# Reload service\nsudo systemctl daemon-reload\nsudo systemctl enable --now redis-server\nsudo systemctl enable --now coco-captive-portal\n```\n\n## License\n\nCopyright (c) 2022 [CoCo Captive Portal](https://github.com/mrzack99s/coco-captive-portal)\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrzack99s%2Fcoco-captive-portal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrzack99s%2Fcoco-captive-portal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrzack99s%2Fcoco-captive-portal/lists"}