Logos is a modular technology stack for building local-first, decentralised applications. Logos consolidates previously separate efforts (Nomos, Codex, Nescience and Waku) under one public identity to reduce cognitive load for developers and users.
If you've ever used Linux, you already understand how Logos works. A Linux distribution isn't solely a single binary it's a runtime foundation, a networking stack, a set of system services, and the applications that together create a complete operating system. Logos follows the same pattern: a core runtime at the base, a privacy-preserving networking layer above it, a set of pluggable modules that provide specific capabilities, and decentralised applications on top that compose those modules. Logos ships with an opinionated default configuration with storage, messaging, and blockchain modules that work out of the box, but you can assemble entirely different distributions with your own selection of modules and configurations.
The stack is organised into distinct layers, each with a clear responsibility. From the bottom up:
Discovery, Peering, and Mixnet: the networking layer. This layer handles how Logos nodes find each other, establish connections, and communicate. Unlike conventional networking stacks, privacy is built in from the ground up. The mixnet routes messages through multiple relay nodes and mixes traffic patterns so that observers cannot determine who is talking to whom. A capability discovery protocol lets nodes advertise and find peers without centralised registries, and the peering layer manages connections across the decentralised network. This shared foundation treats all traffic alike, whether modules above it are storing files, sending chat messages, or processing transactions.
Modules: the system services. Modules are self-contained components that sit on top of the networking layer, each providing a specific capability. Logos ships with three foundational modules, and the architecture is open for anyone to create their own:
-
Blockchain: Runs the consensus layer in the technology stack (i.e. consensus + settlement) and provides the foundation other components build on. Logos Blockchain is a sovereign, censorship resistant foundation for building applications while protecting the privacy of individual participants including node operators.
-
Logos Execution Zone (LEZ): Execution zone (Rollup) running on the Base layer for wallet, token operations, and program deployment with support for public and private contexts (previously referred to as Logos State Separation Architecture or LSSA).
-
Messaging (coordination) handles private, censorship-resistant communication between parties. Logos Delivery provides publish-subscribe messaging for reliable transport. Logos Chat uses Delivery as its transport layer, providing encrypted one-to-one conversations and evolving toward group conversations.
-
Storage (serve frontends and files) provides decentralised, content-addressed file storage and retrieval. Need to host a frontend, serve assets, or store user data without relying on corporate cloud providers? You interact with a straightforward API: store a file, get back a content identifier; provide a content identifier, get back the file.
-
User Modules are the wild card. Because Logos follows a modular architecture, anyone can build modules that plug into the same infrastructure. The runtime loads them, manages their lifecycle, and enables them to communicate with other modules, whether they are Logos defaults or third-party additions. Use cases include wallet and key management, identity, access control, and anything else your application needs.
Dapps: the applications. At the top of the stack sit the decentralised applications that people actually use. These compose the modules below them: a chat app uses messaging and storage; a DeFi app uses blockchain and the Execution Zone; a filesharing app uses storage. The Logos Basecamp is an app built on the Logos Core framework that enables users to interact with the Logos ecosystem. It enables access to third party published applications, running local modules (for example, the node for the blockchain) in the Logos ecosystem and more, while avoiding the dependencies on web-browser interactions. The headless Logos Node starts the same runtime without a UI, ideal for validators, infrastructure operators, or backend services.
Note
To learn more about Logos, visit the Logos main site.
The sections below link to the guides and references for what you can build and run on Logos today.
-
Logos repositories — A comprehensive list of important public repositories in the Logos ecosystem.
-
Logos stack documentation
-
Building Logos modules - How-to's on building modules and UIs to interact with them.
-
Use the Logos Storage module API from an app — Interact with the Logos Storage module API to store and retrieve data from your application.
-
Community resources:
- Zero to Logos App - A short tutorial to understand pieces and have a quick motivating win.
- Find and use an existing module
Please open an issue in this repository describing what you are trying to complete and where you got blocked.
We are consolidating and updating previously fragmented materials into a single, coherent developer experience and source of truth, featuring consistent navigation and terminology. This process is ongoing, and we appreciate your patience as we work to provide comprehensive and up-to-date documentation.
We are also unifying public naming in our documentation to reflect Logos as a single technical stack: Nomos → Logos Blockchain, Codex → Logos Storage, Nescience → Logos Execution Zone (LEZ) and Waku → Logos Messaging. This consolidation makes the architecture easier to navigate by aligning documentation, examples, and terminology under one scheme. Legacy names may still appear in repositories and specifications, but going forward the Logos-first names will be used across our docs.
Our aim is to provide a predictable onboarding path for operators and developers, where they can find what they need and trust what they read.
In 2026 we will release documentation in phases aligned with the project milestones.
We will provide operator guides for those who want to run and support the Logos Blockchain, and developer guides for contributors building decentralized applications on the Logos stack (blockchain, storage, messaging).
We will update this page as sections go live and contribution paths open. Timelines may adjust as the system evolves.