Guides¶

Step-by-step walkthroughs for common tasks on the b'nerd cloud platform. Each guide assumes you have an account and a project set up.

Every guide includes: the relevant API endpoints, CLI commands, Terraform examples where applicable, dashboard navigation path, and a troubleshooting section.

Available guides¶

Foundation¶

First Project & API Token Create your first project and get a static API token for automation. Start here if you're new.

Account Settings Update your display name, change your login email address, and manage your password.

Compute & Firewalling¶

Per-instance Firewalling with Security Groups Create a security group, add ingress rules, and attach it to a server. Covers the API, CLI, Terraform, and dashboard.

Storage¶

Provision S3 Storage End-to-End Create an RGW user, generate S3 access keys, create a bucket, and upload an object — covering the full object storage workflow.

Networking & DNS¶

Manage DNS Create a DNS zone, add records, verify domain ownership, and configure external-dns for automatic Kubernetes record management.

Kubernetes¶

Deploy a Kubernetes Cluster Provision a managed Kubernetes cluster (Gardener) or register an existing cluster, download the kubeconfig, and deploy a workload.

Infrastructure as Code¶

Infrastructure as Code with Terraform Set up the b'nerd Terraform provider, write resource configurations, run plan and apply, and manage state safely.

Monitoring & Alerting¶

Alerting & Escalation The complete path: wire Prometheus Alertmanager in, build a routing + escalation setup, add on-call schedules and absence, tame the noise (cooldown, maintenance windows, quiet hours/digests), try the self-serve tools (test alerts, preview, insights), set up phone/SMS delivery, and understand the full alert lifecycle from fired to resolved.

Security¶

Multi-Factor Authentication Enroll in TOTP, manage recovery codes, handle lockouts, and understand the admin hard-gate and organization-enforced MFA policy.

Developer Environments¶

Working with Workspaces Launch an ephemeral workspace pod, open a pre-configured terminal, use the built-in browser IDE, and clean up — all in a least-privilege, credential-provisioned environment.