name: fluxer

services:
  fluxer:
    image: ghcr.io/hsinghhira/fluxer:latest
    container_name: fluxer
    restart: unless-stopped
    stop_grace_period: 90s
    privileged: true
    environment:
      - TZ=$TZ
      - PUBLIC_URL=http://[ZIMAOS-IP-ADDRESS]:6692
    ports:
      - target: 8080
        published: "6692"
        protocol: tcp
      - target: 6693
        published: "6693"
        protocol: tcp
      - target: 6694
        published: "6694"
        protocol: udp
    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/api/_health"]
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 300s
    deploy:
      resources:
        limits:
          cpus: "4.00"
          memory: 6144M
        reservations:
          cpus: "0.50"
          memory: 1536M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/fluxer/icon.png
    x-casaos:
      id: com.icestore.fluxer
      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: >-
              Required. Replace [ZIMAOS-IP-ADDRESS] with your ZimaOS IP, like
              http://192.168.1.20:6692. Fluxer only works at this one address.
              For voice, video, passkeys and notifications use HTTPS: put
              Fluxer behind a reverse proxy with your own domain (pointed at
              port 6692) and set this to it, like https://chat.example.com.
      ports:
        - container: "8080"
          description:
            en_US: Fluxer web app, API, websocket, media and admin panel, published on host as 6692
        - container: "6693"
          description:
            en_US: Voice and video (LiveKit) over TCP, published on host as 6693. Must stay 6693.
        - container: "6694"
          description:
            en_US: Voice and video (LiveKit) over UDP, published on host as 6694. Must stay 6694.
      volumes:
        - container: /data
          description:
            en_US: >-
              The database (postgres/), uploaded files (seaweedfs/), search
              (meilisearch/), the message bus (nats/), Valkey (valkey/) and
              the secret keys (state/). Back up the whole folder: the keys in
              state/secrets.env can't be changed once Fluxer has data.

x-casaos:
  id: com.icestore.fluxer
  architectures:
    - amd64
    - arm64
  main: fluxer
  author: HSinghHira
  category: Social
  developer: fluxerapp
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/fluxer/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/fluxer/screenshot-1.jpg
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/fluxer/screenshot-1.jpg
  title:
    en_US: Fluxer
  tagline:
    en_US: Free and open source chat and voice for friends, groups and communities.
  description:
    en_US: >-
      Visit: [https://icestore.hsinghhira.me/app/fluxer/](https://icestore.hsinghhira.me/app/fluxer/) for full details


      Fluxer is a free and open source instant messaging and VoIP chat app,
      Discord-style: communities, channels, direct messages, voice and video.
      This is Fluxer in a single container, with PostgreSQL, Valkey, NATS,
      Meilisearch, SeaweedFS file storage and LiveKit inside, one web port and
      one data folder. Every key and password is made for you on first start.


      **Features**


      - Communities with text and voice channels, roles and invites

      - Direct messages and group chats, reactions, link previews and search

      - File uploads, custom emoji and stickers

      - Voice and video calls and screen sharing through LiveKit (needs HTTPS)

      - Admin panel at /admin, and the Fluxer desktop and mobile apps can
        connect to your server


      **How to use?**


      1. Set PUBLIC_URL to your ZimaOS IP (or your HTTPS domain) before you
         install.


      2. Open Fluxer from the Zima OS dashboard.


      3. Enter the setup token from the app's logs to create the admin
         account.


      4. Make a community and invite your friends with an invite link.


      5. The admin panel is at http://[ZIMAOS-IP-ADDRESS]:6692/admin.
  tips:
    before_install:
      en_US: >-
        1. Open the app configuration before you install.


        2. Find PUBLIC_URL. It starts as http://[ZIMAOS-IP-ADDRESS]:6692.
           Put your ZimaOS IP in place of [ZIMAOS-IP-ADDRESS], like
           http://192.168.1.20:6692. You must do this, or Fluxer only
           shows a "set PUBLIC_URL" page.


        3. Voice, video, screen sharing, passkeys and notifications only
           work over HTTPS. For them, use a reverse proxy (like Nginx Proxy
           Manager or a Cloudflare tunnel) with your own domain, point it at
           http://[ZIMAOS-IP-ADDRESS]:6692, and set PUBLIC_URL to your domain,
           like https://chat.example.com. Chat and uploads work without HTTPS.


        4. Keep ports 6693 and 6694 as they are. To call from outside your
           home, forward them in your router (6693 TCP, 6694 UDP).


        5. Fluxer needs a lot of memory. Give it at least 4 GB.


        6. More settings, like email and GIF search, are listed on the
           Fluxer page at https://icestore.hsinghhira.me/app/fluxer/
           (Variables tab). You can add them now or later in the app
           settings.


        7. Start the installation.


        8. Wait about five minutes. The first start sets up the database,
           search and file storage.


        9. Look in the app's logs for the box marked CREDENTIALS. It has
           the setup token. It is printed again on every start.


        10. Open your PUBLIC_URL, like http://192.168.1.20:6692, enter the
            setup token and create your admin account.
  index: /
  port_map: "6692"
  scheme: http
  is_uncontrolled: false
  version: "2026.1109.42841"
  update_at: "2026-11-09"
  release_notes:
    en_US: |-
      - First IceStore release: Fluxer's whole compose bundle in one container, with one web port (6692), voice on 6693 (TCP) and 6694 (UDP), and one data folder.
      - Every secret (database, search, storage, LiveKit, VAPID push keys, the ActivityPub key and the setup token) is made on first start, so each install gets its own.
      - nginx serves upstream's edge routes and the fluxer-static files in place of the Caddy edge and static-proxy.
      - fluxer-api 2026.1109.42841
      - fluxer-gateway 2026.1109.42842
      - fluxer-media-proxy 2026.1109.42917
      - fluxer-push 2026.1109.42836
      - fluxer-app-proxy-self-hosted 2026.1109.42903
      - fluxer-admin 2026.1109.42815
      - fluxer-snowflakes 2026.1109.42849
      - fluxer-users 2026.1109.42852
      - fluxer-gifs 2026.1109.42837
      - fluxer-messages 2026.1109.42854
      - fluxer-unfurl 2026.1109.42918
      - fluxer-static 2026.1109.42914
      - livekit-server v1.12.0
      - meilisearch v1.53
      - seaweedfs 4.52
      - nats 2.14.9-alpine
      - PostgreSQL 16 and Valkey inside
  repo: "https://github.com/fluxerapp/fluxer"
  support: "https://feedback.fluxer.com"
  docs: "https://docs.fluxer.com/operator/"
