# Hubs
Steadybit's hubs are the home for the chaos engineering community! They allow everyone to browse and contribute open-source extensions and templates made for Steadybit. Steadybit hosts its own [Reliability Hub](https://hub.steadybit.com/) and always loves to see contributions via [pull requests](https://github.com/steadybit/reliability-hub-db).
Steadybit's chaos engineering platform lets you connect to a hub to enable [importing experiment templates](https://docs.steadybit.com/install-and-configure/manage-experiment-templates) or integrating [documentation of an action](https://docs.steadybit.com/use-steadybit/experiments/design#action-and-template-documentation).
## Hub Connections
Admins can manage connected hubs in the platform's settings. By default, the platform connects to our [Reliability Hub](https://hub.steadybit.com/).
{% hint style="info" %}
On-premise platform installations connect to a bundled local copy of our Reliability hub's content. Thus, air-gapped environments are supported even when reading data from the hub connection.
{% endhint %}
### Connect New Hubs
Steadybit supports connecting your own hub to the platform. An administrator can manage hub connections via `Settings`> `Hubs`. To add a hub, you need to specify the URL to the hub's index.json (see section [hub convention](#hub-connections)).
Once you've added your hub, you can [import templates from the hub easily](https://docs.steadybit.com/install-and-configure/manage-experiment-templates) and view documentation of actions integrated into the experiment editor.
### Disconnect Hub
When you disconnect a connected hub, you can decide to remove imported templates. Experiments created from a template are never deleted when you disconnect a hub.
## Host Your Own Hub
You can host your own hub to share content within your organization instead of with the public community. This is especially beneficial when you have developed a proprietary extension or need to share organization-specific templates. So far, we only support hosting a private hub's database and connecting it to the platform. We do not yet support hosting a white-labeled hub UI.
### Hub Convention
To host your own hub, you have to serve a JSON-based endpoint via HTTP with a last modified unix timestamp (`lastChange`) and path references to templates and action documentation (see below). The platform will only update the referenced content when the unix timestamp (`lastChange`) has changed.
```json
{
"lastChange": 1719498293,
"templates": [
"/templates/aws-zone.zone-outage/template.json",
"/templates/kubernetes-deployment.time-to-readiness/template.json"
//...
],
"actions": [
"/actions/com.steadybit.extension_container.stress_cpu/description.yml",
"/actions/com.steadybit.extension_host.shutdown/description.yml",
//...
]
}
```
You can check out the `index.json` and all referenced content of [Steadybit's Reliability Hub](https://hub.steadybit.com/) in our [open-source GitHub repository](https://github.com/steadybit/reliability-hub-db/blob/main/index.json).
#### Experiment Templates
Experiment templates, that can be [imported to your platform](https://docs.steadybit.com/install-and-configure/manage-experiment-templates), are listed in the `templates` section and are referencing the [exported templates](https://docs.steadybit.com/install-and-configure/manage-experiment-templates#export-templates-as-files) from your platform.
#### Action Documentation
The [documentation of an action](https://docs.steadybit.com/use-steadybit/experiments/design#action-and-template-documentation) references a `description.yml` with the following format:
```yaml
---
id: com.steadybit.extension_host.shutdown
label: Trigger Shutdown Host
description: Triggers a reboot or shutdown of the host.
icon: |
kind: attack
category: state
targetType: com.steadybit.extension_host.host
extension: com.steadybit.extension_host
promotedActions:
- com.steadybit.extension_aws.ec2_instance.state
tags:
- Host
- Kubernetes
```
The `id` needs to match the action-id provided by your extension.
Also, in the same folder as the `description.yml`, the platform will look for a `summary.mdx` containing Markdown content, see for example:
```markdown
# Introduction
This action executes a shutdown on the host by issuing the `shutdown` command/syscall (depending on the operating system). You can instruct the action to issue a host restart when desired - in which case the command/syscall will be adapted as necessary.
...
# Parameters
| Parameter | Description | Default |
|-----------|---------------------------------------------|---------|
| Reboot | Should the host reboot after shutting down? | true |
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.steadybit.com/integrate-with-steadybit/hubs.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.