Documentation

How TinyInstaller converts a Linux VPS into Windows, and how to run it safely.

Requirements

Item	Requirement
Base OS	Ubuntu 20.04+ or Debian 10+ (fresh install recommended)
Access	root over SSH
RAM	2 GB minimum (4 GB recommended for Windows Server)
Disk	25 GB+ free on the boot disk
Arch	x86_64 (amd64)

Quick start

Log in with your access key on the home page, copy your personalized command, then run it as root:

(wget https://YOUR_DOMAIN/setup.sh -4O tinyinstaller.sh || curl https://YOUR_DOMAIN/setup.sh -Lo tinyinstaller.sh) && bash tinyinstaller.sh free

The last argument is your profile (e.g. free, pro). The script will:

1. Validate your access key against the server.
2. Detect the primary disk, current IP, gateway, and DNS.
3. Print a summary and ask you to type YES to confirm the wipe.
4. Download the Windows raw image and write it to the disk with dd.
5. Inject the static network config and reboot into Windows.

What the script does (technique)

TinyInstaller uses the well-known "image-over-dd" method, the same approach as open-source projects like reinstall.sh and InstallNET.sh:

# simplified
DISK=$(lsblk -dno NAME,TYPE | awk '$2=="disk"{print $1; exit}')
curl -L "$IMAGE_URL" | gunzip | dd of=/dev/$DISK bs=4M status=progress
sync && reboot

Because dd writes raw bytes to the block device, the running Linux system is overwritten in place. The server must reboot from the new image to come up as Windows.

Connecting after install

Allow 5–15 minutes for first boot (Windows runs sysprep + network setup). Then connect:

Host: your.vps.ip
Port: 3389
User: Administrator
Pass: (set in your profile / printed by the script)

Troubleshooting

Symptom	Fix
RDP not reachable	Wait longer; check provider firewall allows TCP 3389.
Stuck at boot	VPS may need BIOS (not UEFI) image; pick the matching profile.
Wrong disk detected	Pass DISK=/dev/vda as an env var before the command.
Key rejected	Confirm the key is active in your account.

Licensing

Evaluation images are time-limited by Microsoft. TinyInstaller does not provide, sell, or activate licenses. You are responsible for licensing Windows for any non-evaluation use.