Skip to main content

Custom ISO

GoMami supports mounting custom ISO images, allowing you to install operating systems not available in the panel or use custom installation media.

Use Cases​

  • Install a specific Linux distribution version
  • Install an OS not available in the panel
  • Use custom pre-configured installation images
  • Install network device operating systems (e.g., RouterOS)

Viewing Available ISOs​

  1. Log in to GoMami, go to the server control panel
  2. Click the Media tab
  3. View available ISO images in the CD/DVD-ROM section
  4. Adjust Boot Order to boot from CD/DVD

Media Tab

Mounting an ISO​

  1. Select the ISO image to mount in the ISO Media section
  2. Click Mount
  3. Change boot order to CD-ROM
  4. Restart the server
info

After mounting an ISO, the server won't automatically restart. You need to manually restart and use the VNC console to complete the installation.

Installing from ISO​

  1. Mount the target ISO image
  2. Change boot order to CD-ROM
  3. Restart the server
  4. Open the VNC console
  5. Follow the installation wizard
  6. After installation, unmount the ISO and change boot order back to Hard Disk
  7. Restart the server again
caution

Installing from ISO will overwrite existing data on the disk. Make sure to back up important files.

Unmounting an ISO​

After installation, make sure to unmount the ISO:

  1. Click Unmount in the ISO Media section
  2. Change boot order back to Hard Disk
  3. Restart the server
tip

If you forget to unmount the ISO and the boot order is set to CD-ROM, the server will boot into the installer again instead of the normal system.

Via API​

# List available ISOs
curl -X GET https://cp.gomami.io/api/server/{id}/iso \
  -H "Authorization: Bearer <your_api_token>"

# Mount ISO
curl -X POST https://cp.gomami.io/api/server/{id}/iso \
  -H "Authorization: Bearer <your_api_token>" \
  -H "Content-Type: application/json" \
  -d '{"iso_id": "<iso_id>"}'

Next Steps​