Genestack Console

P.Industries Foundations Open Source Software Pi.FOSS

Operate the stack from one hub

Genestack is OpenStack on Kubernetes on metal you own. The Console is the portal you install: bring metal in, Talos comes up (API, not SSH), Kubernetes is the plane, OpenStack instances sit on it. Then you stay here to operate.

  1. Install the Console on a machine you control.
  2. Open http://127.0.0.1:8080/ui.
  3. Walk metal → Talos → Kubernetes → OpenStack — or skip to Overview.
  4. Operate from the same hub: honeycomb or 3D, Platform, Observe, Activity.

3D overview

The loop plays the stack up. Drag to orbit, scroll to zoom, click a node.

live demo

Bring metal in

metal → overlay → kubernetes → pods → nova → tenants → edge

What you actually see

Honeycomb and 3D are the Overview

Same environment, two maps. The loop is the product: metal in, Talos, Kubernetes, OpenStack, then operate from this hub. Honeycomb shows one nest at a time — click a cell, a menu blooms (in / see / logs), breadcrumb goes up. 3D stacks the layers so you can orbit the whole cloud. This is sample data; a running Console draws your metal, pods, and instances.

Honeycomb nest

The loop drills each layer, then returns to prod. Click a cell to nest in yourself.

live demo

Bring metal in

Click a cell. Menu blooms: in / see / logs. Breadcrumb goes up.

Get it done

Four steps. Then you are operating.

  1. 1

    Install the Console

    Linux and WSL2: compiled binary. macOS and Windows Git Bash: Docker Desktop. Windows PowerShell: irm https://get.genestack.dev/console.ps1 | iex (runs WSL2). Laptop VM: add --dev.

    curl -fsSL https://get.genestack.dev/console.sh | bash
    curl -fsSL https://get.genestack.dev/console.sh | bash -s -- --dev
  2. 2

    Open the portal

    http://127.0.0.1:8080/ui — SSH tunnel that port if you are off-box. Sign in. After that curl, tenant demo / environment walkthrough is already a full stack (the Console seeds it).

  3. 3

    Guided setup

    New environment → hardware in (Terraform for Rackspace / AWS / Azure / GCP, OVH API, or PXE / SSH / BMC) → fabric → deploy Talos, Kubernetes, OpenStack. Jobs stream until the plane is up.

  4. 4

    Operate from the same hub

    Overview (honeycomb or 3D), Platform (Talos / Kubernetes / OpenStack), Observe (live tiles and series), Activity (jobs you can poll, retry, cancel). kubeconfig and talosconfig download here.

You need toYou open
See the whole environmentOverview — honeycomb nest or 3D stack
Inventory or provision metalHardware — Terraform, OVH, PXE, BMC / Redfish
Walk the stack upGuide — connect → fabric → deploy
Talos: logs, services, upgrade, rebootPlatform → Machines (API, not SSH)
Nodes, workloads, helm, drain, YAMLPlatform → Kubernetes
Instances, images, volumes, consolesPlatform → OpenStack
Live metrics and alertsObserve
Verify, upgrade, retry, cancelActivity — jobs

Screens

Click through the portal

These are the real Console screens, on sample data. Use the sidebar or the list on the right.

Environments healthy
operator

Environments

A tenant holds environments. Each environment is one Genestack cloud.

NameTenantHowStatus

prod

Tenant acme. Guide until it is up; Platform after that — Talos, Kubernetes, OpenStack.

Providers

Terraform bare metal · OVH API · PXE · SSH

Inventory

Rackspace · Terraform
ServerFromRolePower
rs-1Rackspacecontrolon
rs-2Rackspacecontrolon
rs-3Rackspaceworkeron

BMC / Redfish

NameBMCPower
control-aidracon
control-biloon

Guide

import → fabric → deploy → operate
Connect Fabric Deploy Operate
12:01  connect  rackspace / aws / azure / gcp · pxe · ssh · redfish
12:02  fabric   private net up · public only where punched
12:03  talos    control-a Ready · API, not SSH
Machines4
Control2
Workers2
Talosreachable

Machines

NameRoleTalosKubernetes
control-aCP ReadyReady
control-bCP ReadyReady
worker-aW ReadyReady
worker-bW ReadyReady
control-a
Talos v1.10.2 · control-plane · 16 CPU · 64 GiB
API, not SSH. Logs and services query this node through Talos.

Kubernetes

3 Ready
NodeRolePodsStatus
control-acontrol-plane32Ready
control-bcontrol-plane28Ready
worker-aworker41Ready

Workloads

NamespacePodStatus
openstackkeystone-api-0Running
openstacknova-api-0Running
kube-systemcoredns-7d9Running

OpenStack

cloud up
NameFlavorStatus
web-1m1.smallACTIVE
db-1m1.mediumACTIVE
batch-0m1.largeSHUTOFF
ImageStatus
ubuntu-24.04active
cirrosactive
VolumeSizeStatus
db-data100 GiBin-use
backup-150 GiBavailable
NetworkSubnet
privateyour fabrictenant net
publicfloatingholes you punch

Activity

JobLayerStatus
verify clusterKubernetesok
helm upgrade novaOpenStackok
talos upgrade control-aTalosqueued

Access

kubeconfig and talosconfig download from the portal. Jobs live in Activity.

  1. 01

    Environments

    Tenant, then environment. One Console holds many Genestack clouds.

  2. 02

    Hardware

    Terraform, OVH, PXE, SSH, BMC. Inventory and provision in the same place.

  3. 03

    Guide

    Fabric then deploy. Job logs until the plane is up.

  4. 04

    Machines

    Talos: versions, logs, services, upgrades over the API.

  5. 05

    Kubernetes

    Nodes, workloads, helm, kubeconfig — the plane is already there.

  6. 06

    OpenStack

    Instances, images, volumes, consoles. The cloud as workloads on that cluster.

  7. 07

    Activity

    Jobs: verify, helm, Talos upgrades. Config files when you need them.

Pi.FOSS

P.Industries Foundations Open Source Software

This Console is Pi.FOSS from P.Industries — community software to run Genestack, not a vendor control panel. Upstream Genestack remains the Apache-2.0 cloud tree we contribute into.

Docs

The UI is a client of a REST API

Catalog on this site: tenants, environments, hardware, Talos, Kubernetes, OpenStack, jobs — what each endpoint does, the path, and curl. A running Console serves the same catalog at /docs, and OpenAPI at /swagger.

Install

Commands

Console

Fleet hub, then Guided setup. Linux/WSL2 is the ELF; Mac and Windows Git Bash use Docker. --dev is the local AIO VM:

curl -fsSL https://get.genestack.dev/console.sh | bash
curl -fsSL https://get.genestack.dev/console.sh | bash -s -- --dev

Then http://127.0.0.1:8080/ui. Prefix /opt/genestack-console on Linux, ~/genestack-console on Mac/Windows. PowerShell: irm https://get.genestack.dev/console.ps1 | iex.

Upstream Genestack

Install scripts, Helm, Kustomize — the cloud tree we contribute into:

git clone --recurse-submodules \
  https://github.com/rackerlabs/genestack.git

Operator docs: docs.rackspacecloud.com — upstream, not us.

Contact

Contact me

Questions about running the Console, Pi.FOSS, or contributing: [email protected].

Opens your mail client to [email protected]. Nothing is stored on this site.