✉️contact@dadesktop.hu
🌐 Magyar

Custom OS Template (Linux)

DaDesktop already includes many well-known Linux distributions, but occasionally you may need a specific distro that isn't offered here in Hungary. We're glad to accommodate most mainstream Linux distros for this. Just provide the download link for the ISO file and specify which server you'd like the Custom OS template to be published on.

Important:

About Disk Partitioning
1. Custom templates should use a single disk partition, or at most two: one EFI/Boot partition and another partition for the system and data.
2. LVM partitions are not supported – please avoid using LVM.
3. An incorrect partition layout can prevent automatic disk resizing and other features from functioning correctly.

Linux Template

Once we've downloaded the ISO file to your server, you'll find it listed under Admin Menu->OS IMAGES->ISO FILES in your account.

From there, you can set up the template via Admin Menu->OS IMAGES->CUSTOM OS TEMPLATES

Make sure to follow each step in this guide carefully; skipping any part is likely to stop DaDesktop from operating correctly.

  1. Install the operating system.
  2. Configure the default username as "student" and the password as "student".
  3. Enable automatic login for the "student" account.
  4. Apply DaDesktop or your own brand wallpaper.
    DaDesktop or your own brand wallpaper

  5. Some modern distributions now default to Wayland for display. While Wayland is compatible with DaDesktop, we recommend switching back to X11 for the time being.

    To disable Wayland:

    Edit /etc/gdm/custom.conf, for example: 

    # Uncomment the line below to force the login screen to use Xorg
        WaylandEnable=false

    Log out and then log back in.

  6. Install spice-vdagent – using your package manager is typically the best way. Note: this may already be present depending on your distribution.
    • After a successful install, restart the machine. You should see two processes running: spice-vdagent and spice-vdagentd.
    • Install spice-vdagent, using your package manager in linux
  7. Install qemu-guest-agent – again, your package manager is the most straightforward option.
  8. Install X11VNC. For some distros you may need to add extra repositories, such as the 'epel' repo for Red Hat-based systems like Oracle Linux or Rocky Linux.
  9. Configure X11VNC
    • Confirm that X11VNC is installed.
    • Open a root shell with sudo -i.

    • Run the following command to make X11VNC start automatically on reboot: 

      cat > /etc/xdg/autostart/x11vnc.desktop <

  10. Create the desktop notification script by executing these commands: 

    cat > /usr/local/bin/announce-vnc-users.sh <
  11. Reboot the system.

  12. Check your firewall settings to ensure TCP port 5900 is open. You can verify with:

    ss -pntl

  13. Disable the sudo password requirement (recommended).

  14. Confirm that everything is working.

    When you connect, if the URL changes to include a token query parameter, you're all set – that indicates X11VNC is active. The text box at the bottom-left corner of the screen (used for copy/paste between your own desktop and the virtual desktop) should also be functional.

Please Note

For optional extras like:

Please get in touch with DaDesktop Tech Support.