{"id":23974623,"url":"https://github.com/hal/halos-distribution","last_synced_at":"2026-06-19T00:31:02.958Z","repository":{"id":69084827,"uuid":"271781573","full_name":"hal/halos-distribution","owner":"hal","description":"halOS Distribution","archived":false,"fork":false,"pushed_at":"2022-12-28T18:21:44.000Z","size":104,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-02-24T16:39:30.387Z","etag":null,"topics":["monitoring","openshift","wildfly"],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/hal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-06-12T11:26:18.000Z","updated_at":"2022-11-30T09:13:34.000Z","dependencies_parsed_at":"2023-03-11T05:07:38.431Z","dependency_job_id":null,"html_url":"https://github.com/hal/halos-distribution","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hal/halos-distribution","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal%2Fhalos-distribution","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal%2Fhalos-distribution/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal%2Fhalos-distribution/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal%2Fhalos-distribution/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hal","download_url":"https://codeload.github.com/hal/halos-distribution/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hal%2Fhalos-distribution/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34513020,"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-18T02:00:06.871Z","response_time":128,"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":["monitoring","openshift","wildfly"],"created_at":"2025-01-07T05:47:24.833Z","updated_at":"2026-06-19T00:31:02.944Z","avatar_url":"https://github.com/hal.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# halOS Distribution\n\nhalOS stands for **HAL** on **O**pen**S**hift. It is derived from [HAL](https://hal.github.io/)  and allows monitoring and inspection of WildFly and other services running on OpenShift. Although the focus is on WildFly, halOS supports monitoring arbitrary services. This is achieved through the concept of capabilities and extensions.\n\n## Architecture\n\n![halos](halos.svg)\n\nhalOS consists of two parts:\n\n1. [Proxy](https://github.com/hal/halos-proxy) (back-end)\n2. [Console](https://github.com/hal/halos-console) (front-end)\n\nThis repository contains scripts to set up halOS on an OpenShift cluster. The easiest way to get started is to use the [OpenShift sandbox](https://developers.redhat.com/developer-sandbox). The sandbox provides you with a private OpenShift environment in a shared, multi-tenant OpenShift cluster that is pre-configured with a set of developer tools.\n\nFinally, you need to install the OpenShift [command line tools](https://docs.openshift.com/container-platform/latest/cli_reference/openshift_cli/getting-started-cli.html#installing-openshift-cli) `oc`.\n\n## Setup\n\nThe `./setup.sh` script contains everything to set up OpenShift, halOS and sample services: \n\n```shell\nUSAGE:\n    setup.sh [FLAGS] all|openshift|halos|services\n\nFLAGS:\n    -d, --dev           Apply development settings\n    -h, --help          Prints help information\n    -v, --version       Prints version information\n    --no-color          Uses plain text output\n\nARGUMENTS:\n    all                 Setup everything\n    openshift           Setup service account, roles and role binding\n    halos               Deploy halOS service and routes\n    services            Deploy WildFly and Quarkus demo services\n```\n\nYou can set up everything in one go using `./setup.sh all`, or do it incrementally. The latter is useful if you first want to start halOS and then start the services. If you choose to set it up incrementally, make sure to run `./setup.sh openshift` *first*. \n\nhalOS is deployed from [quay.io/halconsole/halos](https://quay.io/repository/halconsole/halos). The demo services are based on [quay.io/hpehl/wildfly-halos-demo](https://quay.io/repository/hpehl/wildfly-halos-demo), [quay.io/hpehl/quarkus-halos-demo](https://quay.io/repository/hpehl/quarkus-halos-demo) and [quay.io/halconsole/wildfly](https://quay.io/repository/halconsole/wildfly).\n\n### Quickstart\n\nTo set up everything and open the console in the browser, simply run \n\n```shell\n./setup.sh all\n./console.sh\n```\n\n## Cleanup\n\nTo clean everything up again, use the `./cleanup.sh` script:\n\n```shell\nUSAGE:\n    cleanup.sh [FLAGS] all|halos|services\n\nFLAGS:\n    -d, --dev           Apply development settings\n    -h, --help          Prints help information\n    -v, --version       Prints version information\n    --no-color          Uses plain text output\n\nARGUMENTS:\n    all                 Cleanup everything\n    halos               Undeploy halOS service and routes\n    services            Undeploy WildFly and Quarkus demo services\n```\n\n## Development\n\nTo run halOS in dev mode, follow the related sections for the [proxy](https://github.com/hal/halos-proxy#development) and the [console](https://github.com/hal/halos-console#development).  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhal%2Fhalos-distribution","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhal%2Fhalos-distribution","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhal%2Fhalos-distribution/lists"}