Documentation

Everything about KynxMachines

From installation to an agent working around the clock in its own VM – every feature explained step by step.

Getting started

KynxMachines uses Hyper-V, the virtualization built into Windows 10 and 11 Pro, Enterprise and Education. You don't need any additional software.

Install

Get the installer via Download and run it. KynxMachines runs with administrator rights because Hyper-V can only be controlled that way.

Enable Hyper-V

If Hyper-V is still off, KynxMachines shows a notice with Enable Hyper-V at the top. Windows then has to restart once.

Virtualization in the BIOS

If KynxMachines reports that virtualization is disabled in the BIOS, Restart into BIOS takes the PC straight there. Enable Intel VT-x or AMD-V (often called “SVM Mode”) in the CPU settings and save with F10.

What you need

Windows 10/11 Pro, Enterprise or Education (64-bit), a processor with virtualization, 16 GB of memory recommended and about 30–60 GB of free storage per VM.

Creating a VM

New VM opens the wizard. Download, setup and configuration then run automatically – the progress appears as a card in the overview.

Windows 11

Choose language, version and edition. KynxMachines downloads the official image directly from Microsoft, verifies it and installs Windows without the setup wizard. Downloaded images are reused for further VMs. You can also pick your own ISO, install.esd or install.wim.

Linux

Choose Ubuntu (preinstalled for Hyper-V, no installation), Ubuntu Desktop, Linux Mint, Fedora or Debian – or any Linux ISO of your own (x64, UEFI).

Resources

Set the name, memory (dynamic – only what's needed is used), CPU cores and disk size. The virtual disk only grows with the space actually used.

First setup

After creation, Windows VMs start into Windows setup (region, keyboard, user). As long as the card shows First setup, don't turn the VM off – the installation would be damaged.

Tip: Create a user with a password in Windows VMs – you'll need it to sign in with sound (see “Sound”).

Overview and VM cards

Every VM appears as a card with a live preview, state, memory, CPU usage and uptime.

Start and stop

Start boots the VM, Stop shuts it down cleanly. A tab never starts a VM by itself.

Rename

Double-click the name on the card – or use the menu (⋮) → Rename.

Card menu

Here you'll find Enable GPU, Disconnect GPU and Update GPU driver, Open in external window (Hyper-V connection), Force power off for a hanging VM and Delete VM (removes the VM and its virtual disk permanently).

Change cores, memory and disk

Via the menu (⋮) → Settings … you can adjust memory, CPU cores and disk size of a VM at any time later on. If the VM is running, it is shut down cleanly for this and started again afterwards. The disk can grow and, for Windows VMs, also shrink – the Windows partition is adjusted automatically, but only shrinks as far as there is free space inside the VM. Linux disks can only grow; Ubuntu uses the new space automatically at the next start.

Status bar

Shows how many VMs are running, how much memory they use and which graphics card was detected.

Tabs and split view

You open VMs in tabs – just like in a browser. Several VMs can be shown side by side in one tab.

Open a tab

Click Open in new tab on the card. If the tab is already open, KynxMachines switches to it.

Split view

Drag one tab onto another: the VMs are shown side by side – up to eight in one tab. Maximize enlarges one of them, Detach into its own tab takes it out again.

Live, Eco and Off

Every view has three modes: Live with mouse and keyboard, Eco with a resource-saving preview (1 frame per second) and Off without any picture. The VM keeps running normally in every mode.

Moving and maximizing the window

The live view moves exactly with the window. Tabs in the background keep their current picture and are there instantly when you switch back.

Live view

In the live view you use the VM like a separate PC. It has its own virtual input devices – your mouse only belongs to the VM when you click into it.

Mouse and keyboard

Click into the view to control the VM. Click outside to work on your PC again.

Paste and copy

Ctrl+V pastes your PC clipboard into the VM – text of any length, images and even files. Whatever you copy in the VM ends up in your PC's clipboard. The helper takes care of this (see below).

View header

At the top you see the connection state and buttons for VPN, resolution, sound, start/stop, the three modes and close.

Resolution

You set the resolution per VM in the view header. The picture is never distorted or stretched.

Dynamic

The VM takes exactly the size of the tab – no borders. When you resize or maximize the window, the VM adapts live.

Fixed resolution

Choose between 1024×768 and 3840×2160. The VM is fitted into the tab with the right aspect ratio; remaining areas stay black.

Up to 4K

New VMs support resolutions up to 3840×2160. KynxMachines switches older VMs over automatically the next time you start them from the app.

Tip: Before you sign in to a Windows VM, the view reconnects briefly when its size changes – afterwards it adapts without interruption.

The helper inside the VM

For clipboard, sound and resolution, KynxMachines installs a small helper (KynxClip) in Windows VMs. It runs invisibly and talks to your PC through a direct Hyper-V channel – without any network, so it also works with VPN or Tor.

One-click installation

If the helper isn't running in a Windows VM yet, a window with Install appears. KynxMachines copies it into the VM and starts it right away – no need to sign in again. The VM must be signed in and unlocked.

Updates

New versions are offered the same way. The old version is replaced automatically.

Status inside the VM

At the bottom right of the VM you'll see the KynxMachines icon. It reports “Clipboard and sound are ready” or – if something doesn't work – the exact reason.

Sound

Sound of a Windows VM is on by default. To get it, KynxMachines shows the VM through the Hyper-V enhanced session – which also brings the clipboard and a free resolution.

One-time confirmation

The first time, Windows inside the VM asks for a confirmation. This sets up the VM to return to its screen unlocked when you close the tab – so agents keep working undisturbed.

Sign in

When you open a tab, sign in to the VM with your Windows password. For a Microsoft account that's the account password – the PIN doesn't work here. As long as the tab stays open, even in the background, you stay signed in.

Sound off

Clicking Sound on turns the sound of this VM off; KynxMachines remembers this per VM. Click again to turn it back on.

Tip: If your password isn't accepted, use the eye icon in the password field to check that special characters or Y/Z arrive correctly.

VPN, Tor and proxy

With the network button on the card or in the header you route all internet traffic of a single VM. Your PC and other VMs are not affected.

Tor

Free and very private. Choose a specific country or “Automatic”.

Proton VPN and your own VPNs

Add WireGuard or OpenVPN files – for example from your Proton account. KynxMachines recognizes Proton files and sorts them by country. Switch between saved profiles with one click.

Proxy

SOCKS5 or HTTP, optionally with sign-in. Credentials are stored encrypted on your PC.

Kill switch and status

If the connection drops, the VM has no internet instead of using your real IP. The button shows the state and the externally visible IP address.

Tip: The first time, KynxMachines downloads a small gateway system once – that takes a moment.

GPU partitioning

Windows VMs can use part of your graphics card (GPU-P). This is available for Windows VMs only.

Turn it on

Enable the GPU in the wizard. The drivers are prepared, and after Windows setup KynxMachines switches the GPU on automatically at the next start of the VM – until then the card shows “GPU from next start”.

Update drivers

After updating the graphics driver on your PC, choose Update GPU driver in the menu – with the VM turned off.

Display

For GPU VMs the live view in the tab always uses the enhanced session – with or without sound. The first time you confirm this once inside the VM; after that you see and use the VM as usual.

Background, quitting and updates

VMs run in Hyper-V – no matter whether the KynxMachines window is open.

Close the window

When closed, KynxMachines keeps running in the notification area of the taskbar. Clicking the icon brings the window back, right-clicking shows the running VMs.

Quit

With Quit … in the taskbar menu, KynxMachines asks what should happen to running VMs: Shut down cleanly, Power off now or Keep VMs running. VMs in their first Windows setup always keep running.

Automatic updates

KynxMachines regularly looks for new versions and downloads them in the background. Update now then appears at the top – otherwise the update is installed at the next start. Running VMs are not affected.

Settings

The gear icon at the top right opens the settings.

Language

KynxMachines is available in 16 languages. The language changes immediately.

Storage location

Choose where new VMs and downloaded images are stored. Existing VMs stay where they are.

About KynxMachines

Shows the version, checks for updates and links to the website, imprint, privacy policy and terms of use.

AI agents in VMs

KynxMachines is built to give agents with “computer use” a dedicated, fully isolated computer.

A screen of its own

The agent works in the VM with its own mouse, keyboard and screen – your PC stays free, so you can keep working or gaming.

Around the clock

Close the tab or set it to Off – the VM keeps running and stays unlocked. The overview always shows a preview.

Isolation

With Tor, VPN or proxy, the agent's traffic is kept apart from your PC – with a kill switch.

Troubleshooting

The most common questions and what helps.

“Hyper-V is not active yet”

Click Enable Hyper-V and restart Windows. Hyper-V is not available with Windows Home.

Paste or sound don't work

Check the KynxMachines icon at the bottom right of the VM. If it's missing, install the helper again via the window or the sound button. Linux VMs have no helper – there, text is typed in when you paste.

Sign-in fails

For a Microsoft account use the account password, not the PIN. Accounts without any password can't sign in to a remote session – create a local user with a password instead.

No picture in the view

Make sure the VM is running. Switch the mode to Eco and back to Live once, or reopen the tab.

More help

Write to us at support@kynxmachines.de.

Ready for your first machine?

Download for free and start your first VM in a few minutes.

Download for Windows

Signed installer · automatic updates