Skip to content

Issue: 666 - Add documentation for custom sample services #227

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
joewxboy merged 2 commits into from
Mar 30, 2026
Merged

Issue: 666 - Add documentation for custom sample services #227

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2465b14
Issue: 666 - Add documentation for custom sample services
euconnor Mar 27, 2026
39dce33
Issue: 666 - Refine custom samples documentation
euconnor Mar 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions docs/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
copyright: Contributors to the Open Horizon project
years: 2025
years: 2025 - 2026
title: All-in-One Mgmt Hub
description: Documentation for Horizon Management Hub
lastupdated: 2025-05-03
lastupdated: 2026-03-27
nav_order: 2
parent: Management Hub
---
Expand All @@ -23,6 +23,7 @@ Read the notes and then run the following command to deploy the Horizon componen
- Support for Windows Subsystem for Linux (WSL 1&2) should also considered **experimental** at this time. WSL2's Ubuntu is based on `init.d` instead of the `systemd` used in standard Ubuntu distributions. The Open Horizon Agent requires `systemd` support so workarounds will simulate systemd usiing [this script](https://gist.githubusercontent.com/djfdyuruiry/6720faa3f9fc59bfdf6284ee1f41f950/raw/952347f805045ba0e6ef7868b18f4a9a8dd2e47a/install-sg.sh). This technique may not be stable and reliable.
- Deployments can be customized by overriding environment variables in [deploy-mgmt-hub.sh](https://github.com/open-horizon/devops/blob/master/mgmt-hub/deploy-mgmt-hub.sh). The variables can be found near the top of the script, right after the usage message and command line parsing code.
All `*_PW` and `*_TOKEN` environment variables and variables in the form `VAR_NAME=${VAR_NAME:-defaultvalue}` can be overridden.
- You can publish your own custom sample services during deployment by setting the `BYO_SAMPLES` environment variable to point to a text file containing GitHub URLs of your service repositories. Each URL must be on a separate line.

Preparation required for **Windows** operating systems:

Expand Down