FugokuFugoku Docs
Mask

Getting Started

Quickstart guide to deploy your first server on Fugoku Cloud

Getting Started

Welcome to Fugoku Cloud! This guide will take you from account creation to your first running server in under 10 minutes.

Prerequisites

  • Email address — For account creation and notifications
  • SSH key — For server access (Ed25519 recommended)
  • Payment method — Credit card, PayPal, or bank transfer

Step 1: Create Account

  1. Visit console.fugoku.com
  2. Click Sign Up
  3. Enter your email and create a password
  4. Verify email — Check your inbox for verification link
  5. Enable 2FA — Highly recommended (TOTP or WebAuthn)

Step 2: Add Payment Method

  1. Navigate to Settings → Billing → Payment Methods
  2. Click Add Payment Method
  3. Choose:
    • Credit/Debit Card — Visa, Mastercard, Amex
    • PayPal — Instant setup
    • Bank Transfer — For $500+/month accounts (contact enterprise@fugoku.com)
  4. Set as default — Primary method for automatic billing

Tip: Set a spending limit in Settings → Billing → Spending Limit to prevent unexpected charges.


Step 3: Add SSH Key

SSH keys are required for server access (password auth is disabled).

Generate SSH Key (if needed)

# Ed25519 (recommended)
ssh-keygen -t ed25519 -C "your-email@company.com"

# RSA (legacy)
ssh-keygen -t rsa -b 4096 -C "your-email@company.com"

Add to Fugoku

Console:

  1. Go to Settings → Credentials → SSH Keys
  2. Click Add Key
  3. Name: laptop (or descriptive name)
  4. Paste public key — Contents of ~/.ssh/id_ed25519.pub
  5. Click Add

CLI:

fugoku ssh-keys add --name laptop ~/.ssh/id_ed25519.pub

Step 4: Create Your First Server

  1. Navigate to Servers (or Virtual Machines)
  2. Click Create Server
  3. Category: Choose Virtual Machine (faster, flexible) or Bare Metal (dedicated hardware)
  4. Image: Select Ubuntu 24.04 LTS (recommended)
  5. Plan: Select vm-standard (4 vCPU, 16 GB RAM, 80 GB NVMe) — $0.017/hr
  6. Region: Choose closest to your users (e.g., ashburn-1 for US East)
  7. Name: my-first-server
  8. SSH Keys: Select the key you added in Step 3
  9. User Data (optional): Paste cloud-init script (see below)
  10. Click Create Server

Provisioning: 30-90 seconds. You'll see status change from creatingactive.

Option B: CLI

# Install CLI
curl -fsSL https://cli.fugoku.com/install.sh | sh

# Authenticate
fugoku auth login

# Create server
fugoku create server \
  --name my-first-server \
  --plan vm-standard \
  --image ubuntu-24.04 \
  --region ashburn-1 \
  --ssh-key laptop

Step 5: Connect to Your Server

Get Server IP

Console: Server detail page → Overview tab → Public IP

CLI:

fugoku servers get my-first-server
# Look for: public_ip: 203.0.113.50

Connect via SSH

# Via CLI (auto key injection)
fugoku ssh my-first-server

# Manual SSH
ssh ubuntu@203.0.113.50

Default users by OS:

OSDefault User
Ubuntu / Debianubuntu / debian
Rocky / AlmaLinuxrocky / almalinux
Fedorafedora
WindowsAdministrator (RDP)

Step 6: Basic Server Setup

Update System

sudo apt update && sudo apt upgrade -y

Install Common Tools

# Essential tools
sudo apt install -y htop vim git curl wget unzip jq tree

# Development tools
sudo apt install -y build-essential python3-pip nodejs npm

# Monitoring
sudo apt install -y htop iotop iftop nethogs

Configure Firewall (Optional)

# Allow HTTP/HTTPS
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

# Allow custom port (e.g., 3000 for Node.js app)
sudo ufw allow 3000/tcp

# Enable firewall
sudo ufw enable

Set Up Docker (Optional)

# Install Docker
curl -fsSL https://get.docker.com | sh

# Add user to docker group
sudo usermod -aG docker $USER
newgrp docker

# Test
docker run hello-world

Step 7: Deploy a Sample App

Quick Nginx + Node.js App

# 1. Create app directory
mkdir -p /var/www/myapp
cd /var/www/myapp

# 2. Create simple Node.js app
cat > server.js << 'EOF'
const http = require('http');
const server = http.createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/html' });
  res.end('<h1>Hello from Fugoku Cloud!</h1><p>Server: ' + require('os').hostname() + '</p>');
});
server.listen(3000, () => console.log('Server running on port 3000'));
EOF

# 3. Install dependencies & run
npm init -y
node server.js &

Configure Nginx Reverse Proxy

sudo tee /etc/nginx/sites-available/myapp << 'EOF'
server {
    listen 80;
    server_name _;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}
EOF

sudo ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

Test: Visit http://&lt;your-server-ip&gt; in browser.


Step 8: Set Up Monitoring & Alerts

View Metrics

Console: Server detail → Metrics tab

  • CPU, RAM, Disk, Network (real-time graphs)
  • Time ranges: 1h, 6h, 24h, 7d, 30d

CLI:

fugoku servers stats my-first-server

Set Up Alerts

# CPU > 80% for 5 minutes
fugoku alerts create \
  --server my-first-server \
  --metric cpu \
  --threshold 80 \
  --duration 5m \
  --notify email:you@company.com

# Disk > 90%
fugoku alerts create \
  --server my-first-server \
  --metric disk \
  --threshold 90 \
  --duration 5m \
  --notify email:you@company.com

# Memory > 85%
fugoku alerts create \
  --server my-first-server \
  --metric memory \
  --threshold 85 \
  --duration 10m \
  --notify email:you@company.com

View Alerts

Console: Server detail → Alerts tab CLI: fugoku alerts list


Step 9: Set Up Backups

Enable Automatic Snapshots

# Daily snapshots, keep 7 days
fugoku snapshots enable \
  --instance my-first-server \
  --schedule daily \
  --retention 7

Manual Snapshot

fugoku snapshots create my-first-server --name before-changes

Restore from Snapshot

fugoku snapshots restore snap-abc123 --name my-first-server-restored

Step 10: Clean Up (If Just Testing)

Stop Server (Saves Money)

# Stop - only pay for storage (~$0.10/GB/mo)
fugoku servers stop my-first-server

# Start again later
fugoku servers start my-first-server

Delete Server (Permanent)

# ⚠️ IRREVERSIBLE - Take snapshot first!
fugoku snapshots create my-first-server --name final-backup
fugoku servers delete my-first-server --confirm

Common Next Steps

GoalNext Guide
Add storageBlock Storage
Private networkingPrivate Networks
Load balancingLoad Balancers
Managed databaseManaged Databases
GPU workloadsGPU Instances
KubernetesManaged Kubernetes
AI/ML modelsAI Model Deployment
Custom domain + SSLDomains & SSL
CI/CD integrationCLI & API
Team collaborationProjects & Settings

Troubleshooting

IssueSolution
Can't SSHCheck firewall (port 22), verify SSH key added, correct user (ubuntu)
Server stuck "creating"Wait 2-3 min, check Console for error, contact support if >5 min
No public IPCheck server status is active, refresh Console
Slow performanceCheck metrics (CPU/RAM/Disk), consider resize
Can't connect to portCheck firewall rules (ufw status + Fugoku firewall)

Support Resources


Security Checklist

  • 2FA enabled on account
  • SSH key added (not password)
  • Firewall: only necessary ports open
  • Automatic updates enabled
  • Backups enabled
  • Alerts configured
  • 2FA on all team members
  • Spending limit set
  • API keys rotated quarterly
  • Unused resources cleaned up

Welcome to Fugoku Cloud! 🚀 You're now ready to build and scale your infrastructure.

On this page