Installing rumahl OS

There are several ways to install rumahl. Which one is right depends on what you plan to do: a dedicated home server device, an existing Linux server or development directly on the host.

Quick install (one-liner)

curl -fsSL https://rumahl.com/install | bash

The installer script detects your system and walks you through the installation — Docker Compose for Linux servers or image flashing to a device (e.g. --device /dev/sdX).

Choosing the right installation method

• rumahl OS (full operating system): the best choice for a dedicated device — Raspberry Pi, mini PC or NAS
• Docker Compose: for existing Linux servers, where rumahl runs as a container stack
• Development mode: directly on the host, if you want to develop rumahl itself

Installing rumahl OS on hardware

1. 1Download the pre-built image: https://github.com/rumahl/rumahl/releases/latest/download/rumahl-os.img.xz
2. 2Verify the checksum: sha256sum rumahl-os.img.xz
3. 3Flash the image to your device (e.g. xzcat rumahl-os.img.xz | sudo dd of=/dev/sdX bs=4M status=progress)
4. 4Boot the device and open the web interface at http://[device-ip]:8126
5. 5Change the default credentials (root / ora) immediately on first login.

Docker Compose on Linux servers

1. 1Clone the repository: git clone https://github.com/rumahl/rumahl.git
2. 2cd rumahl/deploy && cp ../.env.example ../.env
3. 3Start the stack: docker compose up -d
4. 4Wait 30–60 seconds for all services to initialize.
5. 5Open the dashboard at http://localhost:8126.