> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-6-multi-tenant-guides/6.12/configure-multi-tenant/configure-the-multi-tenant-deployment/add-a-host.md).

# Add a Host

We recommend that you continually monitor your servers' CPU, memory, and storage usage. When capacity is reached, consider moving tenants to a new host server.

The host installation package installs and configures the new host, including the settings that will automatically connect the new host to your existing main server.

You can use the same package for all hosts that you want to add, unless you need to change the server's External Host Name or the default admin. In this case, you need to create a new host installer package for each host.

You access a new host with the multi-tenant default admin credentials that generates the host installation file.

All machines (hosts and main accounts) must be time synced, even if they are located in different time zones.

The host machine must meet the [Multi-Tenant Sizing Requirements](/cortex-xsoar-6-multi-tenant-guides/6.12/onboard-multi-tenant/plan-your-multi-tenant-deployment/multi-tenant-sizing-requirements.md).

If creating a host group, follow the same procedure, but you need to add the Elasticsearch cluster URL and the Elasticsearch index prefix. The index prefix enables the indexing of term prefixes to speed up prefix searches. All hosts must have same specifications.

{% hint style="info" %}

### Note

* Once the main host servers are highly available, you can no longer host new accounts on those servers. Existing accounts on the Main host will still exist, but are not highly available. In this situation, Cortex XSOAR recommends that you move the accounts from the Main host to an HA group.
* Run all installation commands as root user.
  {% endhint %}

1. In Cortex XSOAR, go to Settings → **ACCOUNT MANAGEMENT**.
2. Click the **Hosts** tab and select **New Host** from the **New Host/HA Group** dropdown menu on the right.
3. When prompted, click the **Download** button to download and save the installation package.
4. On the new host server machine, run the **`chmod +x demistohost-xxx.sh`** command to make the installer package an executable file.
5. Run the **`sudo ./demistohost-xxx.sh`** command to install the host package.
6. When prompted, enter the listening port used by the Cortex XSOAR server.

   The default listening port is 443.

After you add a host, the host UI is accessible, but there is no content. It serves as a proxy to the tenant accounts from the main account.

**Troubleshooting**

If the new host does not appear in the **ACCOUNT MANAGEMENT** page, try the following.

* Check the status of the host to make sure that the new service is up and running. Try restarting the host server, and if the issue persists, check the logs for potential errors. You can connect to the host using a browser with the Cortex XSOAR server default admin user to access logs and view status.
* Check that there are no firewalls or other network devices that might block access from the new host to the Cortex XSOAR server. You can try telnet or curl from host to the Cortex XSOAR server listening port (default is 443 default) to check if the server is accessible.
* If the host does not connect, log in to the host machine and make sure you can reach the external hostname defined on the main machine.


---

# 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, and the optional `goal` query parameter:

```
GET https://cortex-docs.paloaltonetworks.com/cortex-xsoar-6-multi-tenant-guides/6.12/configure-multi-tenant/configure-the-multi-tenant-deployment/add-a-host.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.