BubbleRAN's TELCOfabric Cluster Access Guide

Overview

The TELCOfabric Cluster is a cloud-native execution environment operated by BubbleRAN, designed for validating O-RAN and AI-RAN artifacts and workflows.

This cluster is available to:

• TelcoFabric members and partners — for evaluating RAN artifacts and infrastructure components
• BubbleRAN customers — for product training and hands-on labs

The environment supports hands-on experimentation with telecom components such as xApps, rApps, AI agents, and network automation workflows.

warning

Use this shared environment responsibly. All sessions are monitored and logged. Unauthorized access is strictly prohibited.

---

Getting Access

Access to the TELCOfabric Cluster is granted via SSH key authentication. There are no passwords — your public SSH key is the credential.

To request access:

1. Generate an SSH key pair on your machine (see instructions below).
2. Send your public key (the .pub file) to BubbleRAN via your dedicated support Discord channel.
3. BubbleRAN will add your key to the cluster and confirm when your access is ready
4. Once confirmed, connect with:

ssh <your-username>@<cluster-hostname>

info

<your-username>@<cluster-hostname> are going to be provided by BubbleRAN once your access is granted.

danger

Never share your private key. Only the .pub file should be sent to us.

---

Generating an SSH Key Pair

Linux

Open a terminal and run:

ssh-keygen -t ed25519 -C "your@email.com"

When prompted:

• Save location: press Enter to accept the default (~/.ssh/id_ed25519)
• Passphrase: recommended, but optional

Your keys will be created at:

• Private key: ~/.ssh/id_ed25519
• Public key: ~/.ssh/id_ed25519.pub

To display your public key (this is what you send us):

cat ~/.ssh/id_ed25519.pub

---

macOS

The process is identical to Linux. Open Terminal (Applications → Utilities → Terminal) and run:

ssh-keygen -t ed25519 -C "your@email.com"

When prompted:

• Save location: press Enter to accept the default (~/.ssh/id_ed25519)
• Passphrase: recommended, but optional

Your keys will be created at:

• Private key: ~/.ssh/id_ed25519
• Public key: ~/.ssh/id_ed25519.pub

To display your public key:

cat ~/.ssh/id_ed25519.pub

To avoid re-entering your passphrase on every connection, add the key to the macOS Keychain:

ssh-add --apple-use-keychain ~/.ssh/id_ed25519

---

Windows

Option A — PowerShell (Windows 10/11, recommended)

Open PowerShell and run:

ssh-keygen -t ed25519 -C "your@email.com"

When prompted:

• Save location: press Enter to accept the default (C:\Users\<you>\.ssh\id_ed25519)
• Passphrase: recommended, but optional

To display your public key:

type $env:USERPROFILE\.ssh\id_ed25519.pub

Option B — PuTTYgen (alternative)

1. Download and open PuTTYgen
2. Select EdDSA as the key type
3. Click Generate and move your mouse to add randomness
4. Click Save public key and Save private key
5. Copy the text shown in the "Public key for pasting" box at the top — this is what you send us

tip

• If using PuTTY to connect, load your private key in Pageant or configure it in your PuTTY session settings.

• If you have multiple keys, you can specify which one to use when connecting:

  ssh -i ~/.ssh/id_ed25519 <your-username>@<cluster-hostname>

• You can also configure this permanently in ~/.ssh/config:

  Host telcofabric
      HostName <cluster-hostname>
      User <your-username>
      IdentityFile ~/.ssh/id_ed25519

  Then simply connect with:

  ssh telcofabric

---

Build. Test. Contribute to the fabric.