terra-os
Fifhdvdy LastnameA super nice OS for my ESP32-C5 supporting a web DE/interface and serial interface, with deuathentication and evil portal functions, and a ton of other nice things.
Comments (0)
Sign in to leave a comment
Architecture
Your ESP32-C5. Fully Unleashed.
terra-os is a flashable, web-based operating system that transforms your ESP32-C5 into a powerful, extensible platform â complete with a desktop environment, plugin ecosystem, and advanced network tools.
Everything Wired In.
Explore the modules that power terra-os.
Web Desktop Environment
A sleek browser-based DE for full system control from any device.
Serial Interface
Direct communication and debugging via serial console.
Plugin System
Extend terra-os with community and custom Python plugins.
Deauth Package
Network deauthentication tools for authorized security testing.
Evil Portal
Captive portal framework for network security assessments.
Flash Utility
One-click firmware flashing with esptool compatibility.
Up and Running in Minutes
Three steps from download to a fully working web desktop on your ESP32-C5.
Download Firmware
Grab the latest terra-os firmware binary from the releases page. Lightweight at under 4 MB, optimized for the ESP32-C5 chipset.
Flash to ESP32-C5
Flash the firmware via USB using esptool or the terra-os web flasher. Full esptool compatibility means zero extra setup required.
Launch Web DE
Connect to your device's local network and open the hosted web desktop environment in any modern browser. You're live.
Advanced Network Tools
Powerful modules for authorized network security testing and research, built directly into terra-os.
Deauth Package
Test the resilience of your wireless networks with the built-in deauthentication module. Identify vulnerable access points and evaluate your network's ability to withstand disconnection attacks in a controlled environment. Ideal for penetration testing workflows on hardware you own.
Evil Portal
Deploy captive portal simulations to assess how users on your network respond to phishing-style login pages. The Evil Portal module lets you craft realistic portal interfaces for social engineering awareness training and security audits. Fully configurable templates included out of the box.
Use responsibly and only on networks you own or have permission to test.
Extend Everything with Plugins.
terra-os ships with a Python-based Plugin SDK that makes it dead simple to browse, install, and build plugins for your ESP32-C5.
Browse Plugins
Install in One Click
Use the CLI for quick installs or the Web Desktop plugin manager for a visual experience.
Build Your Own
- âPython-based SDK â write plugins in familiar Python syntax
- âHot Reload â push changes without reflashing firmware
- âWeb DE Widgets â create custom desktop panels and windows
- âHardware API â direct GPIO, SPI, and I2C access helpers
- âEvent System â hook into OS lifecycle and network events
- âPublish to Registry â share plugins with the community in one command
Build for terra-os
Leverage the Developer API and Plugin SDK to extend terra-os with custom modules. Built on a FastAPI backend, the platform gives you full access to device controls, serial communication, and the web desktop environment. Ship plugins that thousands of ESP32-C5 users can install in one click.
What the Community Says
Hobbyists, developers, and researchers share their experience building with terra-os on the ESP32-C5.
Flashing terra-os onto my ESP32-C5 took under three minutes. The web desktop is incredibly responsive and the plugin ecosystem already has everything I need for my home automation projects.
The Plugin SDK is clean, well-documented, and makes extending terra-os a breeze. I built a custom network scanner plugin in an afternoon using the FastAPI backend hooks.
Finally, a proper OS for the ESP32-C5 that bundles deauth and evil portal tools responsibly. The serial interface for debugging is a game changer for network testing workflows.
Ready to Flash?
Get terra-os running on your ESP32-C5 in under 5 minutes.
FreeOpen SourceNo account required
No comments yet. Be the first!