> For the complete documentation index, see [llms.txt](https://docs.catalyx.solutions/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.catalyx.solutions/catalyx-blockchain-manager/hyperledger-fabric/version-2.4/getting-started/join-a-network.md).
# Join a Network
## Joining a System Channel
After successfully bootstrapping the network, other organizations can join it. Joining the network means joining your ordering nodes to the ordering system channel and fetching or uploading its genesis block.
{% hint style="info" %}
Starting from Catalyst Blockchain Manager v2.3 you can onboard a new organization to the network even if it doesn't host any ordering node. See [Joining with an External Orderer](#joining-a-system-channel-with-an-external-orderer).
{% endhint %}
First, create your organization as described in [Build a Network — Create an Organization](broken://pages/2a5272df9efe5e7d76cf1780bdaadb5ae07230fc#create-an-organization).
Then follow these steps:
**Your organization (Organization 2):**
{% stepper %}
{% step %}
#### Export MSP definition and ordering node JSON profile
{% endstep %}
{% step %}
#### Share your organization MSP and orderer JSON profiles to Organization 1
{% hint style="info" %}
You can create as many ordering nodes as you want but share only one of the ordering nodes' profiles with Organization 1 during this step.
{% endhint %}
{% endstep %}
{% step %}
#### Wait for Organization 1 to add you as a partner
Wait until Organization 1 [adds you as a partner](file:///7571772/network-and-node-management/msp-and-partners.md#how-to-add-organization-as-a-partner) and shares its MSP definition with you with a link to one of its ordering nodes or with the last system channel's genesis block protobuf file.
{% endstep %}
{% step %}
#### Add Organization 1 as a partner
Add its MSP to your partners MSPs.
{% endstep %}
{% step %}
#### Add your ordering node(s) to the system channel
Fetch the genesis block or upload the [genesis block](file:///7571772/network-and-node-management/ordering-service.md#how-to-add-genesis-block).
{% hint style="info" %}
You can add all of your ordering nodes at once or one by one. Note that only consenters which are part of a system channel can be added to application channels.
{% endhint %}
{% endstep %}
{% step %}
#### Wait for sync
Wait a few minutes until the ordering node(s) sync with the network. Your organization is now a part of the blockchain network.
{% endstep %}
{% endstepper %}
**Meanwhile, Organization 1 (any network member) should perform the following steps:**
{% stepper %}
{% step %}
#### Add your MSP definition to the partners list
See [How to Add Organization as a Partner](file:///7571772/network-and-node-management/msp-and-partners.md#how-to-add-organization-as-a-partner).
{% endstep %}
{% step %}
#### Add your organization as an orderer organization
See [Adding Orderer Organizations](file:///7571772/network-and-node-management/ordering-service.md#add-orderer-organizations).
{% endstep %}
{% step %}
#### Share a connection link or genesis block
Copy an external link from one of the ordering nodes connected to the system channel and share it with your organization. Or download the system channel's last block and share it.
{% endstep %}
{% step %}
#### Optionally add your organization to the consortium
See [Adding an Organization to the Consortium](file:///7571772/network-and-node-management/ordering-service.md#how-to-add-an-organization-to-the-consortium).
{% hint style="info" %}
A consortium defines a set of organizations that can create application channels and join them during creation.
{% endhint %}
{% endstep %}
{% endstepper %}
***
## Joining a System Channel with an External Orderer
You can join a system channel with no ordering nodes deployed by your organization. In this case, ask any orderer organization to send you the link to any consenter from a system channel and add it as an external orderer.
**Your organization:**
{% stepper %}
{% step %}
#### Create your organization
Create your organization as described in [Build a Network](broken://pages/2a5272df9efe5e7d76cf1780bdaadb5ae07230fc#create-an-organization). **Note:** You don't need to create ordering sets with orderers in this case.
{% endstep %}
{% step %}
#### Export the MSP definition and share with Organization 1
{% endstep %}
{% step %}
#### Wait for Organization 1 to add you as a partner
Wait until they share their MSP definition and a link to one of the consenters.
{% endstep %}
{% step %}
#### Add Organization 1 as a partner
Add its MSP to your partners MSPs.
{% endstep %}
{% step %}
#### Create an external orderer
Create an external orderer with the provided link.
{% endstep %}
{% endstepper %}
Your organization is now a part of the blockchain network. Meanwhile, **Organization 1** should:
1. Add your organization's MSP definition to the partners list.
2. Add your organization as an orderer organization.
3. Copy an external link from one of the consenters of the system channel and share it with your organization.
4. Optionally [add your organization to the members of a consortium](file:///7571772/network-and-node-management/ordering-service.md#how-to-add-an-organization-to-the-consortium).
Upon completion, your peers can be added to application channels (or create application channels if your organization was added to a consortium).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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.catalyx.solutions/catalyx-blockchain-manager/hyperledger-fabric/version-2.4/getting-started/join-a-network.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.