VacuumOS v.1.0

Official Release | March 2026

Raspberry Pi4 - 64 bit

VacuumOS 1.0 marks the inaugural release of a custom Linux-based operating system built using the Yocto Project. Engineered specifically for embedded systems, this initial version provides dedicated support for Raspberry Pi 4 hardware.

VacuumOS is designed to serve as the minimal core environment required to host and run the Quantum Field Platform and its constituent applications. By stripping away unnecessary overhead, it ensures maximum performance and stability for edge computing tasks.

The system is ready for remote management and industrial messaging out of the box:

• Remote Access: Full support for OpenSSH, allowing secure terminal management.
• Web Services: Includes NGINX, pre-configured for serving local dashboards or APIs.
• Messaging: Integrated Mosquitto (MQTT Broker) for seamless IoT communication and data exchange within the Quantum Field Platform.
• Development: Powered by Python 3, providing a versatile environment for custom scripts and platform logic.

Field	Details
VacuumOS build version	1.0.0 (LTS)
Base Distribution	Yocto Project (Scarthgap 5.0)
Linux Kernel	6.6.63
Architecture	ARMv8 / aarch64 (64-bit)
Compiler	aarch64-poky-linux-gcc (GCC) 13.4.0
Linker	GNU ld (GNU Binutils) 2.42.0
Build Host	Debian GNU/Linux 13.3
Init System	Systemd
Default Credentials	root / admin (Change on first boot!)
Default IP address	192.168.1.250
Release Date	March, 03 2026
License	CC BY-NC-SA 4.0
Manifest	license.manifest
Source code	https://github.com/Quantum-Field-Platform/vacuum-os/releases/tag/v.1.0.0
Image file (SHA256)	vacuum-1.0.0-image-raspberrypi4-64.rootfs.wic.bz2 8f69e8250ed7e439f129ead3f203c3eaed208551646af8449156de88905c5f76
Image file size (compressed)	91.9 MB
Tested Hardware	Raspberry Pi 4 Model B (Rev 1.1)

Build manifest and custom layers are available on our https://github.com/quantum-Field-Platform repository. Complete source archives for all components can be provided upon request.

Changelog

[1.0.0] - 2026-03-03

Added

• Hardware Support: Full support for Raspberry Pi 4 (64-bit).
• Tools: Added openSSH, python3, nginx, and mosquitto to the default image.

Changed

• NA

Fixed

• NA

Removed

• NA

Flash VacuumOS image

Follow these steps to flash VacuumOS onto your microSD card or USB drive.

Prerequisites

• A microSD card (at least 4GB recommended).
• The VacuumOS image file: vacuum-X.Y.Z-image-raspberrypi4-64.rootfs.wic.bz2.
• A flashing tool (see options below).

---

Option 1: Using Raspberry Pi Imager or BalenaEtcher (Recommended)

This is the easiest method for Windows, macOS, and Linux users. Both tools support compressed .bz2 files natively.

1. Download and install Raspberry Pi Imager or BalenaEtcher.
2. Insert your microSD card into your computer.
3. Open the tool and select "Use Custom" (for Pi Imager) or "Flash from file" (for Etcher).
4. Select your vacuum-X.Y.Z-image-raspberrypi4-64.rootfs.wic.bz2 file.
5. Select your microSD card as the target storage.
6. Click Write/Flash and wait for the process to finish.

---

Option 2: Using Command Line (Linux & macOS)

If you prefer the terminal, you can decompress and flash the image in a single pipeline using bzcat and dd.

[!CAUTION] Be extremely careful with the of=/dev/sdX parameter. Selecting the wrong drive will result in permanent data loss on your host machine.

1. Identify your SD card device (e.g., /dev/sdb or /dev/mmcblk0):Bashlsblk
2. Flash the image:Bashbzcat vacuumos-v1.0.0-rpi4.wic.bz2 | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync (Replace /dev/sdX with your actual device identifier).

---

First Boot

1. Insert the microSD card into your Raspberry Pi 4.
2. Connect an Ethernet cable to your local network or connect a USB-to-TTL Serial Debug cable (UART) to the GPIO pins (115200 baud).
3. Power on the device.
4. Wait for Initialization: The system may take a moment on the first boot to automatically resize the partitions and initialize the environment.
5. Login Methods:
   • SSH (Network): Use your terminal to connect to the default static IP: ssh root@192.168.1.250
   • Serial Console: Use a tool like PuTTY, Tera Term, or screen to access the debug console.
6. Default Credentials:
   • User: root
   • Password: admin