# nephele

**Repository Path**: mirrors_NVIDIA/nephele

## Basic Information

- **Project Name**: nephele
- **Description**: Tools to deploy GPU clusters in the Cloud
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-12-16
- **Last Updated**: 2026-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NEPHELE

## Prerequisites

### Install enroot
```bash
sudo apt update -y
arch=$(dpkg --print-architecture)
echo $arch

curl -fSsL -O https://github.com/NVIDIA/enroot/releases/download/v3.4.1/enroot_3.4.1-1_${arch}.deb
curl -fSsL -O https://github.com/NVIDIA/enroot/releases/download/v3.4.1/enroot+caps_3.4.1-1_${arch}.deb
sudo apt install -y ./*.deb
rm enroot*
```

### Install terraform and ansible
```bash
curl -fsSL https://apt.releases.hashicorp.com/gpg | sudo apt-key add -
sudo apt-add-repository "deb [arch=$(dpkg --print-architecture)] https://apt.releases.hashicorp.com $(lsb_release -cs) main"
sudo apt update
sudo apt install -y build-essential terraform ansible
```

### Check installation
```bash
terraform --version
ansible --version
```

### If using Azure, additionally install the Azure CLI
https://docs.microsoft.com/en-us/cli/azure/install-azure-cli
```bash
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash
az login
```


## Setup

### Cloning the repo
Remember to include the recursive flag for submodules.
```bash
git clone --recursive https://github.com/NVIDIA/nephele.git
```

### Edit cluster configuration
```bash
vi nephele.conf
```

### One time setup
```bash
export CONTAINERIZED_BUILD=1
./nephele init
```

### Create the cluster
```bash
./nephele create
```

### Connect to the cluster
Headnode:
```bash
./nephele connect
```

Specific compute node - e.g. x8a100-0000
```
./nephele connect x8a100-0000
```

### Destroy the cluster
```bash
./nephele destroy
```