# dennysubke/dennys-umbrel-app-store architecture

> Architecture diagram of the GitHub repository dennysubke/dennys-umbrel-app-store, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dennysubke/dennys-umbrel-app-store
- Repository: https://github.com/dennysubke/dennys-umbrel-app-store

## Overview

##### Project type and purpose
- This is not a traditional full-stack web app but an orchestration/catalog repository for community-curated Umbrel “apps.”
- Its purpose is to supply Umbrel with a custom App Store index and per-app Docker compose and Umbrel-app manifest files so community users can install dozens of self-hosted services on their Umbrel node.

##### File structure
- Top level:
- README.md – describes the store, lists apps, instructions.
- umbrel-app-store.yml – Umbrel manifest for the overall custom App Store UI.
- Many “denny-<appname>/” directories – each contains:
– docker-compose.yml – defines the containers for that app (services, images, volumes, ports).
– data/ (and sometimes config/) – persistent volume mount points for that app.
- Pattern: each app is packaged as its own microservice stack (often a single container + data volume). The store itself is likewise a container that reads the index and displays the UI.

##### README for additional insights
- The store’s frontend is the Umbrel App Store UI (likely a static or Node.js service defined in umbrel-app-store.yml).
- There is no unified backend code—each app’s docker-compose handles its own service deployment.
- The umbrella “app store” manifest simply points Umbrel at this repo’s index.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Browser["User Browser"]:::external
    ReverseProxy["Umbrel Reverse Proxy"]:::proxy

    subgraph ControlPlane
        UI["App Store UI Container"]:::control
        Supervisor["Umbrel Supervisor"]:::control
        Engine["Docker Engine"]:::control
        Index["umbrel-app-store.yml"]:::doc
        Readme["README.md"]:::doc
    end

    subgraph "Community Apps"
        subgraph ActualBudget
            ABComp["docker-compose.yml"]:::doc
            ABMan["umbrel-app.yml"]:::doc
            ABVol["data/"]:::data
            ABCont["ActualBudget Container"]:::app
        end
        subgraph Akaunting
            AKComp["denny-akaunting/docker-compose.yml"]:::doc
            AKMan["denny-akaunting/umbrel-app.yml"]:::doc
            AKVol["denny-akaunting/data/"]:::data
            AKCont["Akaunting Container"]:::app
        end
    end

    Browser -->|"HTTP GET"| ReverseProxy
    ReverseProxy --> UI
    UI -->|"reads index"| Index
    UI --> Supervisor
    Supervisor -->|"install command"| Engine
    Engine --> ABCont
    Engine --> AKCont
    ABCont --> ABVol
    AKCont --> AKVol
    ReverseProxy --> ABCont
    ReverseProxy --> AKCont

    click Index "https://github.com/dennysubke/dennys-umbrel-app-store/blob/master/umbrel-app-store.yml"
    click Readme "https://github.com/dennysubke/dennys-umbrel-app-store/blob/master/README.md"
    click ABComp "https://github.com/dennysubke/dennys-umbrel-app-store/blob/master/denny-actualbudget/docker-compose.yml"
    click ABMan "https://github.com/dennysubke/dennys-umbrel-app-store/blob/master/denny-actualbudget/umbrel-app.yml"
    click ABVol "https://github.com/dennysubke/dennys-umbrel-app-store/tree/master/denny-actualbudget/data/"
    click AKComp "https://github.com/dennysubke/dennys-umbrel-app-store/blob/master/denny-akaunting/docker-compose.yml"
    click AKMan "https://github.com/dennysubke/dennys-umbrel-app-store/blob/master/denny-akaunting/umbrel-app.yml"
    click AKVol "https://github.com/dennysubke/dennys-umbrel-app-store/tree/master/denny-akaunting/data/"

    classDef control fill:#AED6F1,stroke:#21618C,stroke-width:2px
    classDef app fill:#F5B041,stroke:#B9770E,stroke-width:2px
    classDef data fill:#ABEBC6,stroke:#239B56,stroke-width:2px
    classDef proxy fill:#D5DBDB,stroke:#7B7D7D,stroke-width:2px
    classDef doc fill:#F9E79F,stroke:#B7950B,stroke-width:2px
    classDef external fill:#E8DAEF,stroke:#6C3483,stroke-width:2px
```
