https://github.com/deqrocks/deq

Homelab control plane with native Android app, Wear OS, and Android Auto. SSH-based control from a dashboard. Single Python file. Zero dependencies. Dynamic config. No YAML.
https://github.com/deqrocks/deq

backup-tool bare-metal dashboard deq file-manager homarr homelab homepage-app nas pihole python raspberry-pi scheduled-tasks self-hosting ssh-connection ssh-manager system-monitor task-scheduler wake-on-lan wol

Last synced: 19 days ago
JSON representation

Homelab control plane with native Android app, Wear OS, and Android Auto. SSH-based control from a dashboard. Single Python file. Zero dependencies. Dynamic config. No YAML.

• Host: GitHub
• URL: https://github.com/deqrocks/deq
• Owner: deqrocks
• License: other
• Created: 2025-12-06T12:14:59.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2026-01-11T22:44:04.000Z (24 days ago)
• Last Synced: 2026-01-11T23:51:25.589Z (24 days ago)
• Topics: backup-tool, bare-metal, dashboard, deq, file-manager, homarr, homelab, homepage-app, nas, pihole, python, raspberry-pi, scheduled-tasks, self-hosting, ssh-connection, ssh-manager, system-monitor, task-scheduler, wake-on-lan, wol
• Language: Python
• Homepage: https://deq.rocks
• Size: 4.63 MB
• Stars: 156
• Watchers: 1
• Forks: 8
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# DeQ

Your homelab under control. From anywhere.




A single Python file providing SSH-based control via a web interface,

connected to a native Android app, Wear OS, and Android Auto.





Zero dependencies. Dynamic config. No YAML.



![DeQ Hero](assets/DeQ-Hero-ambient.jpg)



Website ·

Documentation ·

FAQ ·

Press Kit ·

Patreon



## Table of Contents

- [Features](#features)

- [Concept](#concept)

  - [Ambitions](#ambitions)

  - [Architecture](#architecture)

  - [Connectivity](#connectivity)

- [Free Android App](#free-android-app)

- [Paid Android Pro App](#paid-android-pro-app)

- [Installation](#installation)

- [Screenshots](#screenshots)

- [License](#license)

- [Credits](#credits)





## Features

- **Onboarding** – Automatic device and container population

- **Native Android App** - Background monitoring, push notifications, widgets, Android Auto, Wear OS

- **DeQ Nodes** - Devices with app connect to a node network that can WOL your server when you're not at home

- **Device Control** - Wake-on-LAN, shutdown, suspend, Docker start/stop

- **Device Monitoring** - CPU load, temp, SMART... with alarm thresholds

- **File Manager** - Dual-pane browser, copy/move/upload between devices

- **Scheduled Tasks** - Wizard guided automated backups, wake, shutdown, and scripts

- **Extension API** - Write Python extensions. Build custom GUIs. Make DeQ whatever you need.

- **HTTP API** - Connect Home Assistant, Tasker, or build your own automations

- **Theming** - Custom colors, wallpapers, transparency effects

- **Quick Stuff** - Bookmark and script runner buttons with support for Lucide, Dash...

- **PWA Support** - Install as app on any device

- **Admin Auth** - Adds an additional security layer





## Concept

### Ambitions

- Less, but better. Lateral thinking over complexity.

- Use what’s there. Move fast. Make it useful.

DeQ is an ultra-lightweight network control layer that exposes the raw power of SSH on mobile devices — without unnecessary abstraction.





### Architecture

At the core of DeQ is a single Python file: `server.py`.

It lives on your server and acts as the entire control layer.

What makes it powerful — yet lightweight — is its restraint.

DeQ is essentially SSH commands wrapped in a thin, vanilla Python shell.

There are no dependencies beyond Linux and Python.

The same file serves a dashboard-like web interface.

It is mobile-first, responsive, and accessible from any browser.

We deliberately restrict `server.py` to a maximum size of 500 KB.

It currently sits at around 350 KB.

A typical fresh installation, managing a few devices, containers, and tasks,

uses roughly 20 MB of RAM and virtually no CPU.





### Connectivity

The native Android app, Android Auto, and Wear OS sync directly with `server.py`.

The server, in turn, connects to your host and other network devices via SSH.

DeQ is not a dashboard. DeQ is a control layer disguised as a dashboard.

It is a well-connected control layer with access to core homelab functions

such as Wake-on-LAN, task scheduling, and file management —

as well as sensors and context from your mobile devices.

For example, the Android app can automatically put selected containers or servers

to sleep when you plug in your phone at night —

and wake them again when you unplug it in the morning.

### Your Control Layer

The core remains lean. How you extend it is up to you.

HTTP API connects Home Assistant, Tasker, or your custom scripts.

Extension API lets you write Python that adds custom sections to the web interface.

Drop shell scripts into `/opt/deq/scripts/` for quick automation.

DeQ provides the infrastructure. You build what you need.

![DeQ Connectivity](assets/DeQ-connectivity.svg)

---

## Free Android App









Push notifications · Full web interface


Native companion app with background monitoring and push notifications when devices go offline, containers stop, or backups fail. **Ad-Free**









## Paid Android Pro App



Ambient Mode with BCD clock


**DeQ Pro** adds powerful automation and visualization features. Your purchase keeps this project alive as a full-time effort.

  

    

      Feature

      Description

    

  

  

    

      Widgets

      5 widget styles for home and lock screen

    

    

      Live Wallpaper

      Animated status display as background

    

    

      Ambient Mode

      Wall-mount display with BCD clock, OLED optimized

    

    

      Android Auto

      Homelab status in your car

    

    

      Wear OS

      Watch app, tile, and complications

    

    

      Sleep With Me

      Homelab sleeps when you sleep

    

  












Sleep With Me: Plug in to sleep · Unplug to wake








Android Auto integration










Wear OS app · Quick tile







## Installation

```bash

wget https://github.com/deqrocks/deq/releases/latest/download/deq.zip

unzip deq.zip -d deq && cd deq

sudo ./install.sh

```

The installer asks a few questions and gives you your access URL.

**Full setup guide:** [deq.rocks/documentation](https://deq.rocks/documentation.html)

## Screenshots



User onboarding wizard




Dual-pane file manager (desktop)




Dual-pane file manager (phone)




Task scheduler




Desktop PWA


## License

CC BY-NC 4.0 - Free for personal use, no commercial use without permission.

## Credits

- [Lucide Icons](https://lucide.dev)

- [Dashboard Icons](https://github.com/walkxcode/dashboard-icons)

- [JetBrains Mono](https://www.jetbrains.com/mono/)