Skip to content

Element & Matrix — The Interface

Centered image

What is this?

If Forgejo is our ledger, Element is our voice. This page explains how we use the open-source Matrix protocol to replace Slack, Discord, and email, creating a sovereign communication layer where every chat room maps directly to a structural node in our organization.

Just give me the abstract

SmartupOS uses Element (a chat client) running on a custom Synapse server (Matrix protocol). To maintain a secure laboratory environment, our server operates as a "defederated island"—completely cut off from the wider internet. Access is strictly token-only. Inside, the chat interface is rigidly structured into Spaces and Rooms that perfectly mirror our 6 Groups of Productivity, serving as the interface where citizens debate, coordinate, and trigger Engelbot commands.

Why Not Slack or Discord?

Traditional startups default to Slack, Discord, or Microsoft Teams. For a Smartup, these are fundamentally incompatible for three reasons:

  1. Proprietary Lock-in: You do not own your organization's history; the platform does.
  2. Attention Extraction: They are designed with algorithms, badges, and notifications meant to hijack human attention, reducing deep work.
  3. Top-Down Control: Their permission architectures are hardcoded for traditional corporate hierarchies (Admin → Manager → User).

The Solution: We deployed our own Synapse server using the open-source Matrix protocol, accessed via the Element web client. We own the server, we own the data, and we control the architecture.

The "Isolated Island" Architecture

Matrix is famous for its "federation"—the ability for servers to talk to one another seamlessly. We turned it off.

Smartup Zero operates as a strictly defederated island.

A Controlled Laboratory

To run a clean sociotechnical experiment, you must control the variables. By isolating our server, we guarantee that every single user inside the environment is a verified, licensed Smartup Owner. There is no spam, no external noise, and no shadow-participants.

Security & Access Rules:

  • No Public Sign-ups: Access to owners.smartup0.org requires a single-use cryptographic registration token generated by a Team Captain upon license purchase.
  • No External Federation: Our endpoints return 404 to the outside Matrix network. We cannot message outside servers, and they cannot message us.
  • EU-Sovereign: Hosted entirely on a dedicated Hetzner VPS in Germany.

Mapping the Ledger to the Chat

In most companies, chat channels are created randomly (#random, #watercooler, #project-x). In SmartupOS, the chat architecture is mathematically bound to the Ledger.

We use Matrix Spaces (folders) and Rooms (channels) to mirror the 6 Groups of Productivity perfectly.

flowchart TD
    subgraph Matrix ["Element Interface (owners.smartup0.org)"]
        F[Space: 1_general_forum<br/>All Citizens]
        W[Space: 2_workplace<br/>Workers Only]

        T1[Subspace: 3_1_leadership_team]
        T2[Subspace: 3_3_developer_team]

        R1[Room: 5_3_0 Onboarding Objective]
        R2[Room: 6_1_3_0 Script Refactor Task]

        F --> W
        W --> T1
        W --> T2
        T2 --> R1
        R1 --> R2
    end

Access by License Tier

Your physical access to these spaces is governed by your License (enforced by Engelbot):

  • Watch License: Auto-joined to 1_general_forum. You can observe, vote, and debate, but you cannot see the internal machinery of the teams.
  • Work/Campaign License: Auto-joined to both 1_general_forum and 2_workplace. From the workplace, you are granted access to your specific Team subspaces based on your applied Roles.

The User Experience

To a citizen, SmartupOS does not look like a complex array of Python scripts and CSV files. It looks like a clean, focused chat app.

  • The General Forum

    Screenshot of General Forum

    The public square. Where cross-team announcements are made and strategic votes take place.

  • Commanding Engelbot

    Screenshot of Engelbot Command

    The command line for non-coders. Citizens use natural language !commands in specific rooms to interact with the Ledger.

Under the Hood (For Engineers)

For those interested in the technical deployment, our Media Team Infrastructure relies on a highly efficient, Dockerized stack.

View Infrastructure Details

The Stack:

  • OS: Ubuntu 24.04 LTS (Hetzner Cloud VPS)
  • Server: Matrix Synapse (PostgreSQL 15 backend)
  • Client: Element Web (served statically)
  • Proxy: Caddy (Reverse proxy with automatic Let's Encrypt SSL)

Routing Architecture:

  • smartup0.org routes to the public landing page and handles the raw Matrix Client API.
  • owners.smartup0.org serves the Element Web interface to our citizens.
  • Only ports 22 (SSH), 80, and 443 are open to the world. All configuration is done via local Ed25519 keypair SSH access.

Next Step: Meet the Midfielder

Element is just the interface. To understand how typing a message in a chat room actually updates our Git-based ledger, you need to meet the orchestrator connecting them both: Engelbot.

Ready to Contribute?

Join the Project

Become a Smartup Zero owner

Join via Open Collective

Reach out

Contact the 3_1_leadership_team with questions or remarks

Contact US

```