Self-host Terminus
0.79.0Self-hosted server for managing TRMNL e-paper devices
- Stars
- 763
- Ports
- 2300 (HTTP web interface), 2443 (HTTPS web interface)
- Requires
- PostgreSQL, Valkey
ghcr.io/usetrmnl/terminusWhat is Terminus?
Terminus is a self-hosted web server built with Ruby and Hanami for managing TRMNL e-paper displays on your local network or cloud. It serves as a Build Your Own Server implementation compatible with the TRMNL Core service but adds features not available in the hosted version. The software provides a web dashboard for managing devices, sensors, screens, playlists, extensions, models, palettes, and firmware updates. It uses PostgreSQL for the database, Valkey (or Redis/Dragonfly) for caching, Sidekiq for background jobs, Rodauth for authentication, and Puma as the web server. Deployment options include Docker, Docker Compose, Render, and Raspberry Pi. The project is currently in beta (pre-1.0) and licensed under MIT.
Terminus alternatives
LaraPaperLaraPaper is a self-hosted, open-source TRMNL BYOS server built with Laravel. It manages e-paper devices, generates screens via plugins, recipes, or API.CompareLaraPaper with Terminus
TermixThis open-source, self-hosted server manager turns SSH access, remote desktop, file transfers, container control and monitoring into toggleable plugins.CompareTermix with Terminus
terminusdbOpen-source knowledge graph database with built-in version control for branching, merging, and time-travel queries using Datalog.Compareterminusdb with Terminus
lab-dashSelf-hosted dashboard for managing homelab applications with customizable grid layout, service health checks, and PWA support.Comparelab-dash with Terminus
WebterminalSelf-hosted open-source bastion host unifying SSH, RDP, VNC, database and Kubernetes access via browser or native clients with fine-grained auth and full audit.CompareWebterminal with Terminus
dashwiseAn open-source, self-hosted homelab dashboard with built-in auth and OIDC SSO, widgets, link groups with uptime monitoring, RSS news and Spotlight-style search.Comparedashwise with Terminus
swiftwaveSwiftWave: self-hosted open source PaaS for deploying apps on any server. Alternative to Heroku/Netlify/Render with 1GB RAM min and integrated app store.Compareswiftwave with Terminus
TipiOpen-source homeserver manager that installs and updates around 300 self-hosted apps through a web dashboard, with Traefik handling networking and HTTPS automatically.CompareTipi with Terminus
Should you self-host Terminus?
Terminus scores 50/100 on selfhost.directory (how scoring works) and ranks #63 of 104 in Home Automation. It has 763 GitHub stars, +2 in the last 30 days.
There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.
Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is MIT-licensed and written mostly in Ruby.
Its closest alternative on selfhost.directory is Home Assistant (91/100, 91 841 stars). It scores higher overall, so compare the two before you pick. See Terminus vs Home Assistant side by side.
Features
- Background Jobs
- Device Dashboard
- Device Management
- Extensions
- Firmware Management
- Model Support
- Palette Management
- Playlists
- REST API
- Screen Import
- Screen Management
- Sensor Support
- User Accounts
- User Management
Terminus README
Terminus is a Ruby/Hanami web server that allows you to manage TRMNL devices running on your own local network or hosted cloud. This is our flagship BYOS implementation that aims to be compatible with our TRMNL Core server but also different since this open source solution provides features not possible in our Core application.
⚠️ This is a Beta software as we haven’t reached 1.0.0 status as of yet. This means — while we strive to reduce the number of changes that require effort on your part to a minimum — there will be times when changes can’t be avoided.
More in Device Management
ThingsboardSelf-hosted source-available IoT platform for device management, data processing, and visualization with rule engine and multi-protocol support.
WikiSuiteWikiSuite is the most comprehensive and integrated Open Source enterprise solution, offering a suite of tools for communication, collaboration, data management, and more.
zpl-restzpl-rest is an open-source, self-hosted print server that lets any system send JSON to print ZPL labels on Zebra printers via a REST API and web UI with live preview.
zwave-js-uiOpen-source, self-hosted Node.js and Vue app to manage a Z-Wave network from a web control panel and bridge devices to MQTT, including Home Assistant discovery.
bamdudeSelf-hosted, open-source command center for Bambu Lab 3D printers with real-time monitoring, per-printer queues, print archiving, Telegram bot, and filament tracking.
BroadlinkManagerA self-hosted web application to discover Broadlink hardware and manage IR/RF codes. Runs via Docker or Home Assistant add-on with a React interface.
CNCjsAn open-source, self-hosted web interface for running CNC machines on Grbl, Marlin, TinyG or Smoothie firmware, with a widget workspace, 3D tool-path view and DRO.
CortenDeskSelf-hosted RustDesk console bundling ID server, relay, and browser client in one Docker image. Fixes signed-in client issues, adds fleet management, access control.
CUPSOpenPrinting CUPS is a self-hosted, open-source printing system supporting AirPrint, IPP Everywhere, and legacy PPD drivers with web admin, CLI tools, and C API.
cups-avahi-airprintSelf-hosted Docker image that runs CUPS with Avahi to make network printers discoverable via AirPrint on iOS and macOS devices.
ESPConnectOpen-source, self-hosted browser tool for ESP32 and ESP8266 boards: read chip info, map partitions, manage SPIFFS/LittleFS/FAT files, back up and flash firmware.
ESPHomeOpen-source firmware toolchain for DIY smart home devices: describe an ESP32 or RP2040 in YAML, then compile, flash and update it via a self-hosted web dashboard.
0 comments