Quick Start

Get up and running with NubiferOS in 10 minutes

This guide gets you from first boot to managing cloud resources in under 10 minutes.

Prerequisites

  • NubiferOS installed (see Installation)
  • At least one cloud account (AWS, Azure, or GCP)
  • Your cloud credentials ready

First Boot

After installing NubiferOS, you'll be greeted with the GNOME desktop. The workspace indicator in the top panel shows "No Workspace" until you create one.

Step 1: Create Your First Workspace

Open a terminal (Ctrl+Alt+T) and create a workspace:

AWS Workspace

nubifer-workspace create \
  --name "AWS Production" \
  --provider aws \
  --account-id 123456789012 \
  --account-name "prod-account" \
  --region us-east-1

Azure Workspace

nubifer-workspace create \
  --name "Azure Dev" \
  --provider azure \
  --account-id "subscription-id" \
  --account-name "dev-subscription" \
  --region eastus

GCP Workspace

nubifer-workspace create \
  --name "GCP Staging" \
  --provider gcp \
  --account-id "project-id" \
  --account-name "staging-project" \
  --region us-central1

Step 2: Add Credentials

nubifer-creds aws configure-sso \
  --sso-start-url https://my-company.awsapps.com/start \
  --sso-region us-east-1 \
  --account-id 123456789012 \
  --role-name DevRole

# Login (opens browser)
nubifer-creds aws sso-login --profile production

Option B: AWS Access Keys

nubifer-creds aws add-access-key \
  --profile production \
  --access-key-id AKIAIOSFODNN7EXAMPLE \
  --secret-access-key wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

Option C: Interactive Mode

nubifer-creds add
# Follow the prompts

Step 3: Switch to the Workspace

nubifer-workspace switch "aws production"

Your prompt changes to show the active workspace:

[☁️ prod-account | us-east-1] user@nubiferos:~$

Step 4: Verify It Works

# AWS
aws sts get-caller-identity

# Azure
az account show

# GCP
gcloud config list

You should see your account information.

For production workspaces, enable read-only mode:

# Lock the workspace
nubifer-workspace ro

Your prompt now shows the lock indicator:

[🔒 RO][☁️ prod-account | us-east-1] user@nubiferos:~$

To make changes, temporarily unlock:

# Unlock for 15 minutes (requires sudo)
sudo nubifer-workspace rw -d 15

# Make your changes...

# Lock again (or wait for auto-lock)
nubifer-workspace ro

Quick Reference

CommandShortcutDescription
nubifer-workspace createnw createCreate a new workspace
nubifer-workspace listnw listList all workspaces
nubifer-workspace switch <name>nw-switch <name>Switch to a workspace
nubifer-workspace currentnw-contextShow current workspace
nubifer-workspace ronw roEnable read-only mode
sudo nubifer-workspace rwsudo nw rwEnable read-write mode
nubifer-creds add-Add credentials (interactive)
nubifer-creds list-List all credentials
nubifer-creds test aws-Test AWS credentials

Tip: Use nw as a shortcut for nubifer-workspace in all commands.

Common Workflows

Managing Multiple AWS Accounts

# Create workspaces for each account
nubifer-workspace create --name "AWS Prod" --provider aws --account-id 111111111111
nubifer-workspace create --name "AWS Dev" --provider aws --account-id 222222222222
nubifer-workspace create --name "AWS Staging" --provider aws --account-id 333333333333

# Switch between them
nubifer-workspace switch "aws prod"
terraform plan

nubifer-workspace switch "aws dev"
terraform apply

Multi-Cloud Management

# Morning: AWS infrastructure
nubifer-workspace switch "aws prod"
aws s3 ls

# Afternoon: Azure deployment
nubifer-workspace switch "azure staging"
az deployment group create ...

# Evening: GCP monitoring
nubifer-workspace switch "gcp logging"
gcloud logging read ...

Safe Production Changes

# 1. Switch to production
nubifer-workspace switch "aws prod"

# 2. Verify read-only mode
nubifer-workspace current
# Mode: 🔒 Read-Only

# 3. Unlock for 15 minutes
sudo nubifer-workspace rw -d 15

# 4. Make changes
terraform apply

# 5. Lock immediately (or wait for auto-lock)
nubifer-workspace ro

Troubleshooting

Prompt Not Updating

# Reload shell integration
source /etc/nubifer/shell-integration.sh

# Or restart your shell
exec bash

Credentials Not Working

# Verify credentials are loaded
nubifer-creds verify

# Test specific provider
nubifer-creds test aws

Can't Switch Workspaces

# List available workspaces
nubifer-workspace list

# Check workspace ID
nubifer-workspace list --verbose

Next Steps