Quick Start

Get rumahl running in under five minutes with Docker. All you need is Docker Desktop or Docker Engine and Git.

Prerequisites

• Docker Desktop or Docker Engine installed

• Git installed

1. Clone and start

git clone https://github.com/rumahl/rumahl.git
cd rumahl/deploy
cp ../.env.example ../.env
docker compose up -d

Wait 30–60 seconds for all services to initialize.

2. Access the dashboard

3. Create your first admin account

1. 1Open the Dashboard at http://localhost:8126

1. 1Click Create Account

1. 1Fill in your details and set a strong password

1. 1Log in with your new credentials

4. Explore the dashboard

The left sidebar provides navigation to all sections:

• Dashboard – smart home widget grid

• rumahl Control – admin panel (users, system, plugins)

• rumahl Assist – AI chat interface

• App Store – install apps and plugins

Add a widget: click Edit Dashboard → Add Widget → choose a type (Entity Card, Weather, Clock, …) → configure → save.

5. Connect Home Assistant (optional)

1. 1Go to rumahl Control → Home Assistant

1. 1Enter the address of your instance and your credentials

1. 1Devices and entities appear automatically in the dashboard