> For the complete documentation index, see [llms.txt](https://documentation.tjhsst.edu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.tjhsst.edu/services/cluster/setup.md).

# Setup

To set up a new Cluster node, you should follow these steps:

## Network it

Do the standard steps to add new entries for a node (or block of nodes) to DHCP and DNS.

{% content-ref url="/pages/-LKyHNaVNeKK4jQQx1Mw" %}
[DNS](/technologies/networking/dns.md)
{% endcontent-ref %}

{% content-ref url="/pages/-LMyKcsuAHkSR0WSwn3h" %}
[DHCP](/technologies/networking/dhcp.md)
{% endcontent-ref %}

Also make sure the switches/routers/cables are set up right.

## Install Ubuntu

The preferred method is to use Netboot, but a regular Ubuntu install stick works as well. If installing from an USB stick make sure your hostname matches the one specified in DNS/DHCP.

## Setup SSH

See [SSH Setup](#setup-ssh) page to learn more on how to setup SSH for the clusters.

## Run the Ansible play

First, make sure you add the node to an existing/new host group that has the `cluster` role. Then, you can just run `ansible-playbook`, sit back, kick your feet up, and wait for the install to finish.