Quick Start

Create your first virtual machine in minutes

Quick Start

This guide walks you through creating your first virtual machine after installing Infinibay.

Prerequisites

  • Infinibay installed and running (see Installation Guide)
  • A web browser
  • At least one ISO image (Windows or Linux)

Step 1: Access the Web Interface

Open your browser and navigate to:

http://<your-server-ip>:3000

You'll see the Infinibay login page.

Step 2: Log In

Use the default admin credentials:

  • Email: admin@example.com
  • Password: password

Note: These credentials are created when the database is seeded. If login fails, run the seed script:

cd backend
npm run db:seed

You can customize these defaults by setting DEFAULT_ADMIN_EMAIL and DEFAULT_ADMIN_PASSWORD environment variables before seeding.

Important: Change these credentials immediately after first login. Go to Settings → Account to update your password.

Step 3: Create a Department

Departments organize VMs and apply shared firewall rules.

  1. Navigate to Departments in the sidebar
  2. Click Create Department
  3. Enter a name (e.g., "Development")
  4. Click Create

Step 4: Upload an ISO (if needed)

If you haven't uploaded an ISO during installation:

  1. Navigate to ISOs in the sidebar
  2. Click Upload ISO
  3. Select your Windows or Linux ISO file
  4. Wait for the upload to complete

Step 5: Create Your First VM

  1. Navigate to VMs in the sidebar
  2. Click Create VM
  3. Complete the creation wizard:

Basic Information

  • Name: Give your VM a descriptive name
  • Department: Select the department you created
  • Operating System: Choose your OS type

Resources

  • Template: Select a preset (Small, Medium, Large) or customize:
    • CPU Cores: 2-4 recommended for general use
    • Memory: 4GB minimum for Windows, 2GB for Linux
    • Disk Size: 50GB minimum for Windows, 20GB for Linux

Installation

  • ISO: Select the ISO you uploaded
  • User Credentials: Configure username and password for the VM

Note: Infinibay uses unattended installation to automatically configure the OS. No manual installation steps are required.

Graphics

  • Protocol: SPICE (recommended) or VNC
  • Leave other settings as default
  1. Click Create

The VM will be created and start the OS installation automatically.

Step 6: Connect to Your VM

Once the VM is running:

  1. Click on the VM in the list
  2. Click Connect or the display icon
  3. A SPICE/VNC viewer will open in your browser

For the best experience, install the virt-viewer client:

# Ubuntu/Debian
sudo apt install virt-viewer

# Fedora
sudo dnf install virt-viewer

Then click Download Connection File and open it with virt-viewer.

Step 7: Wait for OS Installation

Infinibay uses unattended installation to automatically:

  1. Partition the disk
  2. Install the operating system
  3. Create user accounts with your configured credentials
  4. Install VirtIO drivers (Windows) or guest tools (Linux)
  5. Configure network settings

Installation typically takes 10-20 minutes depending on the OS and hardware. The VM will reboot automatically when complete.

Tip: You can monitor installation progress through the SPICE/VNC console.

What's Next?

  • Configure Firewall: Add rules in VMs → [Your VM] → Firewall
  • Install Guest Agent: Enable health monitoring (see InfiniService)
  • Add More Users: Create accounts in Settings → Users

Quick Tips

Performance

  • Use SPICE for better graphics
  • Enable VirtIO drivers for disk/network
  • Allocate appropriate resources (don't over-provision)

Security

  • Change default admin password
  • Configure department firewall rules
  • Keep VMs updated

Troubleshooting

  • VM won't start: Check system resources (RAM, disk space)
  • No display: Verify SPICE port isn't blocked
  • Slow performance: Install VirtIO drivers

Next Steps

Need help? Check the full documentation or report an issue.

Previous
Installation Guide
Next
VM Lifecycle Management