{"id":15148692,"url":"https://github.com/edoardolagreca/werc-on-openbsd","last_synced_at":"2025-08-26T06:37:03.411Z","repository":{"id":119432457,"uuid":"593240822","full_name":"EdoardoLaGreca/werc-on-openbsd","owner":"EdoardoLaGreca","description":"Automate Werc setup on OpenBSD.","archived":false,"fork":false,"pushed_at":"2025-05-09T13:19:25.000Z","size":116,"stargazers_count":10,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-09T13:33:34.966Z","etag":null,"topics":["cgi","httpd","openbsd","werc"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EdoardoLaGreca.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,"zenodo":null}},"created_at":"2023-01-25T15:06:38.000Z","updated_at":"2025-05-09T13:19:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"3e11e521-8ead-4a4d-b0f8-9bed7fe2c90b","html_url":"https://github.com/EdoardoLaGreca/werc-on-openbsd","commit_stats":{"total_commits":93,"total_committers":2,"mean_commits":46.5,"dds":"0.33333333333333337","last_synced_commit":"878fc0e90f6df39eb9ab7e3c6e8a5160416a944d"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/EdoardoLaGreca/werc-on-openbsd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EdoardoLaGreca%2Fwerc-on-openbsd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EdoardoLaGreca%2Fwerc-on-openbsd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EdoardoLaGreca%2Fwerc-on-openbsd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EdoardoLaGreca%2Fwerc-on-openbsd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EdoardoLaGreca","download_url":"https://codeload.github.com/EdoardoLaGreca/werc-on-openbsd/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EdoardoLaGreca%2Fwerc-on-openbsd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272186211,"owners_count":24888333,"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-26T02:00:07.904Z","response_time":60,"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":["cgi","httpd","openbsd","werc"],"created_at":"2024-09-26T13:21:46.139Z","updated_at":"2025-08-26T06:37:03.406Z","avatar_url":"https://github.com/EdoardoLaGreca.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"werc-on-openbsd\n===============\n\nAutomate [Werc](http://werc.cat-v.org/) setup on\n[OpenBSD](https://www.openbsd.org/).\n\n## Useful info\n\nBoth the `setup.sh` and `unsetup.sh` scripts, in their latest available version\n([v2.2](https://github.com/EdoardoLaGreca/werc-on-openbsd/releases/tag/v2.2)),\nhave been successfully tested on the latest available OpenBSD stable release\n(7.7). Prior or later versions of OpenBSD may not work.\n\n**Performing an OpenBSD release upgrade (e.g. by using\n[sysupgrade(8)](https://man.openbsd.org/sysupgrade.8)) may break the current\nWerc installation.** It is advised to always test your Werc installation after\nperforming either a system upgrade, a Werc update, or a plan9port update. If it\nstops working, head to [Troubleshooting](#troubleshooting).\n\n### Limitations\n\nFor now, the installation resulting from `setup.sh` has only been tested with\n`GET` requests, which it supports for sure. Other types of HTTP requests may or\nmay not work (e.g. the \"user login\" feature). The URL-based rules in\n`/etc/httpd.conf` (`location ...`) may need a different configuration to\nsupport HTTP requests other than `GET`.\n\n### Other info\n\nA [tagged commit](https://git-scm.com/book/en/v2/Git-Basics-Tagging) with tag\nname of the form `vN.M` (where `N` and `M` are integers), is a commit whose\nworking tree has the following characteristics:\n\n1. It has a readable README which is carefully divided into sections and\ncontains instructions about the usage of the two scripts. The README file may\nalso contain checksums for the two scripts.\n2. It has the two scripts, `setup.sh` and `unsetup.sh`, tested against the\nlatest OpenBSD stable version (available at that point in time) with positive\noutcome and no known side effect on the system.\n\nSince the testing process is manual I may overlook some edge cases, sometimes\non purpose and sometimes not. I care about the quality of my software but\ntesting every single line against all its possible edge cases is really time\nconsuming and unsustainable.\n\n## Rationale\n\nSee [doc/rat.md](doc/rat.md).\n\n## Usage\n\nSee [doc/usage.md](doc/usage.md).\n\n## Testing\n\nSee [doc/testing.md](doc/testing.md).\n\n## Troubleshooting\n\n### Werc stops working after upgrading OpenBSD\n\nIt may happen that, after upgrading OpenBSD, your website stops working and\nonly shows \"500 internal server error\".\n\nWhile the exact reason behind this behavior should be carefully analyzed and\nunderstood, you might try uninstalling and re-installing Werc and plan9port.\nThe procedure is the same as if you were to update them.\n\n```sh\ndoas ./unsetup.sh uninst rm9env\ndoas ./setup.sh inst mk9env\n```\n\n## Checksums\n\nLook for files ending in \".sum\".\n\n## License\n\nEverything in this repository is licensed under the [ISC\nlicense](https://en.wikipedia.org/wiki/ISC_license). See LICENSE file.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedoardolagreca%2Fwerc-on-openbsd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fedoardolagreca%2Fwerc-on-openbsd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedoardolagreca%2Fwerc-on-openbsd/lists"}