A simple, zero-configuration script to quickly boot FreeBSD ISO images using QEMU

Update README to replace script execution with command alias for consistency

+22 -22
+22 -22
README.md
··· 72 72 Simply run without any arguments to boot the latest stable FreeBSD release: 73 73 74 74 ```bash 75 - ./main.ts 75 + freebsd-up 76 76 ``` 77 77 78 78 This will automatically download and boot FreeBSD 14.3-RELEASE. ··· 82 82 Specify just a version to auto-download and boot: 83 83 84 84 ```bash 85 - ./main.ts 14.3-RELEASE 86 - ./main.ts 15.0-BETA3 87 - ./main.ts 13.4-RELEASE 85 + freebsd-up 14.3-RELEASE 86 + freebsd-up 15.0-BETA3 87 + freebsd-up 13.4-RELEASE 88 88 ``` 89 89 90 90 ### Boot from URL ··· 92 92 Download and boot from a specific URL: 93 93 94 94 ```bash 95 - ./main.ts https://download.freebsd.org/ftp/releases/amd64/amd64/ISO-IMAGES/15.0/FreeBSD-15.0-BETA3-amd64-disc1.iso 95 + freebsd-up https://download.freebsd.org/ftp/releases/amd64/amd64/ISO-IMAGES/15.0/FreeBSD-15.0-BETA3-amd64-disc1.iso 96 96 ``` 97 97 98 98 ### Boot from Local File 99 99 100 100 ```bash 101 - ./main.ts /path/to/your/freebsd.iso 101 + freebsd-up /path/to/your/freebsd.iso 102 102 ``` 103 103 104 104 ### Customize VM Configuration ··· 107 107 108 108 ```bash 109 109 # Custom CPU and memory 110 - ./main.ts --cpu host --memory 4G 14.3-RELEASE 110 + freebsd-up --cpu host --memory 4G 14.3-RELEASE 111 111 112 112 # Specify number of CPU cores 113 - ./main.ts --cpus 4 --memory 8G 15.0-BETA3 113 + freebsd-up --cpus 4 --memory 8G 15.0-BETA3 114 114 115 115 # Attach a disk image for persistent storage 116 - ./main.ts --drive ./freebsd-disk.img --disk-format qcow2 14.3-RELEASE 116 + freebsd-up --drive ./freebsd-disk.img --disk-format qcow2 14.3-RELEASE 117 117 118 118 # Download to specific location 119 - ./main.ts --output ./downloads/freebsd.iso 15.0-BETA3 119 + freebsd-up --output ./downloads/freebsd.iso 15.0-BETA3 120 120 121 121 # Combine all options 122 - ./main.ts --cpu qemu64 --cpus 2 --memory 1G --drive ./my-disk.qcow2 --disk-format qcow2 --output ./my-freebsd.iso 122 + freebsd-up --cpu qemu64 --cpus 2 --memory 1G --drive ./my-disk.qcow2 --disk-format qcow2 --output ./my-freebsd.iso 123 123 ``` 124 124 125 125 ### Get Help ··· 156 156 157 157 ```bash 158 158 # Use different CPU type 159 - ./main.ts --cpu qemu64 14.3-RELEASE 159 + freebsd-up --cpu qemu64 14.3-RELEASE 160 160 161 161 # Allocate more memory 162 - ./main.ts --memory 4G 15.0-BETA3 162 + freebsd-up --memory 4G 15.0-BETA3 163 163 164 164 # Use more CPU cores 165 - ./main.ts --cpus 4 14.3-RELEASE 165 + freebsd-up --cpus 4 14.3-RELEASE 166 166 167 167 # Attach a persistent disk image 168 - ./main.ts --drive ./freebsd-storage.qcow2 --disk-format qcow2 14.3-RELEASE 168 + freebsd-up --drive ./freebsd-storage.qcow2 --disk-format qcow2 14.3-RELEASE 169 169 170 170 # Save ISO to specific location 171 - ./main.ts --output ./isos/freebsd.iso https://example.com/freebsd.iso 171 + freebsd-up --output ./isos/freebsd.iso https://example.com/freebsd.iso 172 172 173 173 # Combine multiple options with persistent storage 174 - ./main.ts --cpu host --cpus 4 --memory 8G --drive ./vm-disk.qcow2 --disk-format qcow2 --output ./downloads/ 14.3-RELEASE 174 + freebsd-up --cpu host --cpus 4 --memory 8G --drive ./vm-disk.qcow2 --disk-format qcow2 --output ./downloads/ 14.3-RELEASE 175 175 ``` 176 176 177 177 ## 🖥️ Console Setup ··· 228 228 229 229 ```bash 230 230 # Increase memory to 4GB 231 - ./main.ts --memory 4G 231 + freebsd-up --memory 4G 232 232 233 233 # Use a different CPU type 234 - ./main.ts --cpu qemu64 234 + freebsd-up --cpu qemu64 235 235 236 236 # Increase CPU cores to 4 237 - ./main.ts --cpus 4 237 + freebsd-up --cpus 4 238 238 239 239 # Add persistent storage 240 - ./main.ts --drive ./freebsd-data.qcow2 --disk-format qcow2 240 + freebsd-up --drive ./freebsd-data.qcow2 --disk-format qcow2 241 241 242 242 # Combine options with persistent storage 243 - ./main.ts --cpu host --cpus 4 --memory 8G --drive ./vm-storage.qcow2 --disk-format qcow2 14.3-RELEASE 243 + freebsd-up --cpu host --cpus 4 --memory 8G --drive ./vm-storage.qcow2 --disk-format qcow2 14.3-RELEASE 244 244 ``` 245 245 246 246 ### Creating Disk Images