Docs / App Marketplace / Custom ISO Upload: Installing Your Own Operating System

Custom ISO Upload: Installing Your Own Operating System

By Admin · Feb 25, 2026 · Updated Apr 23, 2026 · 159 views · 1 min read

What Is Custom ISO?

Kazepute supports uploading your own ISO files to install any operating system. This lets you run specialized distributions, custom builds, or operating systems not available in our standard templates.

How It Works

  1. Upload your ISO file through the deploy form
  2. We transfer it to our infrastructure
  3. A VM is created with the ISO attached as a virtual CD-ROM
  4. You connect via VNC to complete the installation
  5. After installation, the ISO is detached

Supported ISO Types

  • Any x86_64 (AMD64) operating system
  • Linux distributions (Arch, Gentoo, NixOS, etc.)
  • BSD variants (FreeBSD, OpenBSD)
  • Network installers

Installation Process

  1. Deploy your Breeze and select "Custom ISO"
  2. Upload your ISO file
  3. Once provisioned, open the VNC console from your dashboard
  4. Boot from the ISO and install the OS to the virtual disk
  5. Configure networking manually using the IP address shown in your dashboard
  6. Reboot — the system will boot from the installed OS

Network Configuration

During installation, you will need to configure networking manually:

  • IP address: shown in your Breeze dashboard
  • Netmask: provided with your IP
  • Gateway: provided with your IP
  • DNS: 1.1.1.1 and 8.8.8.8

Important Notes

  • Custom ISO VMs have resource limits applied for security
  • The ISO is deleted from our systems after transfer to the VM
  • You are responsible for all software and security on custom OS installations

Was this article helpful?