name: monolith services: monolith: image: ghcr.io/hsinghhira/monolith:latest container_name: monolith restart: unless-stopped stop_grace_period: 90s privileged: true environment: - TZ=$TZ - PUBLIC_URL=http://localhost:6138 ports: - target: 8080 published: "6138" protocol: tcp volumes: - type: bind source: /DATA/AppData/$AppID/data target: /data bind: create_host_path: true healthcheck: test: ["CMD", "curl", "-fsS", "-o", "/dev/null", "http://127.0.0.1:8080/healthz"] interval: 30s timeout: 10s retries: 5 start_period: 300s deploy: resources: limits: cpus: "2.00" memory: 3072M reservations: cpus: "0.00" memory: 512M labels: icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/monolith/icon.png x-casaos: id: com.icestore.monolith envs: - container: TZ description: en_US: >- Your time zone. It is filled in from your ZimaOS time zone. Leave it unless you need another. - container: PUBLIC_URL description: en_US: >- The https address you open Monolith at, like https://monolith.example.com. Monolith only signs you in on https, or on http://localhost:6138 on the ZimaOS box itself, so to use it from other devices put it behind a reverse proxy (or Tailscale) with https and type that address here. ports: - container: "8080" description: en_US: Monolith web app and API, published on host as 6138 volumes: - container: /data description: en_US: >- The PostgreSQL database (postgres), uploaded files and installed add-ons (storage) and this install's own keys (state/secrets.env). Back this folder up; the data can't be read without the keys. x-casaos: id: com.icestore.monolith architectures: - amd64 main: monolith author: HSinghHira category: Productivity developer: MaxJafar icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/monolith/icon.png thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/monolith/screenshot-1.webp screenshot_link: - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/monolith/screenshot-1.webp - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/monolith/screenshot-2.png - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/monolith/screenshot-3.png - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/monolith/screenshot-4.png - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/monolith/screenshot-5.png title: en_US: Monolith tagline: en_US: A personal workspace for pages, projects, calendar and databases description: en_US: >- Monolith brings your pages, projects and everyday tools into one self-hosted workspace. Write documents, organize records, plan projects and build a dashboard around what matters to you. This is Monolith in a single container, with its API, gateway, web app and PostgreSQL inside, one port and one data folder. Secret keys are made for you on first start. **Features** - Docs: nested pages, rich blocks, references, backlinks and inline databases - Databases with typed properties, relations, filters and table, board and calendar views - Projects in boards, lists, timelines and Gantt; Actions for Today and Upcoming - Calendar, Rooms for workspace chat, and a dashboard of widgets - Workspaces with owner, editor and viewer roles - Optional add-ons (Atlas, Automations, Agents, Redraw, Gym, Tech Lab) and MCP/CLI for AI agents - Web app, plus Windows and macOS desktop apps **How to use?** 1. Monolith needs an https address to sign in from other devices. Put it behind a reverse proxy (or Tailscale) and set PUBLIC_URL to that address. On the ZimaOS box itself, http://localhost:6138 works. 2. Open your PUBLIC_URL address. 3. Create your account. The first account is the owner. 4. Make your first page, project or database. tips: before_install: en_US: >- 1. Monolith only signs you in on an https address. You must set this up to use it from your phone or other computers. 2. Make an https address for Monolith with a reverse proxy (like Nginx Proxy Manager or Caddy) or Tailscale. Point it at http://[ZIMAOS-IP-ADDRESS]:6138. 3. Set PUBLIC_URL to that https address, like https://monolith.example.com. 4. Without it, Monolith only works in a browser on the ZimaOS box itself, at http://localhost:6138. 5. More settings, like admins, add-ons and call relays, are listed on the Monolith page at https://icestore.hsinghhira.me/app/monolith/ (Variables tab). You can add them now or later in the app settings. 6. Start the installation. The first start takes 2 to 5 minutes. 7. Open your PUBLIC_URL address. Create your account right away: the first account is the owner. index: / port_map: "6138" scheme: http is_uncontrolled: false version: "v0.1.22" update_at: "2026-10-29" release_notes: en_US: |- - First version in IceStore, on port 6138 - Single container: Monolith's API server, Go gateway and web app, with PostgreSQL 17 inside - Built from upstream release v0.1.22 (upstream publishes no server image), on node 22.23.4-bookworm-slim - Database migrations run on every start, as upstream's migrate service does - Master key, JWT key and database passwords are made on first start and kept in /data/state/secrets.env - amd64 only for now: the build compiles the whole workspace, which is too slow under arm64 emulation - Left out: upstream's host updater (update by updating the app in ZimaOS instead) repo: "https://github.com/MaxJafar/monolith" support: "https://github.com/MaxJafar/monolith/issues" docs: "https://monolith-site-maxjafars-projects.vercel.app/docs/self-hosting"