{
  "schema_version": 1,
  "generated_at": "2026-10-23T00:00:00.000Z",
  "canonical_url": "https://openlogs.fyi/tools/libredesk",
  "slug": "libredesk",
  "name": "Libredesk",
  "tagline": "Self-hosted customer support desk with a shared inbox for a team.",
  "replaces": {
    "summary": "Paid customer support desk services, such as Zendesk.",
    "products": [
      {
        "slug": "zendesk",
        "name": "Zendesk",
        "vendor": "Zendesk",
        "url": "https://openlogs.fyi/alternatives/zendesk"
      }
    ]
  },
  "stack": [
    {
      "kind": "language",
      "name": "Go"
    },
    {
      "kind": "database",
      "name": "PostgreSQL"
    },
    {
      "kind": "database",
      "name": "Redis"
    }
  ],
  "deployment_methods": [
    "docker_compose"
  ],
  "requirements": {
    "min_ram_mb": null,
    "min_cpu_cores": null,
    "source_url": null
  },
  "license": {
    "spdx": "AGPL-3.0",
    "class": "osi",
    "source_url": "https://github.com/abhinavxd/libredesk/blob/5668a2a2c503b9304404d8f3620131b2990cbb99/LICENSE"
  },
  "business_model": {
    "value": "unknown",
    "notes": "The README at the pinned commit does not state a business model, so it stays unknown.",
    "source_url": "https://github.com/abhinavxd/libredesk/blob/5668a2a2c503b9304404d8f3620131b2990cbb99/README.md",
    "checked_at": "2026-10-22"
  },
  "difficulty": {
    "value": "medium",
    "reason": "3 services (2 database or broker: postgres, redis), 4 volume mounts, no env values to set, no elevated host access. Heuristic score 5 of 11: medium. A source checkout is needed, so the rating is at least medium."
  },
  "repository": {
    "owner": "abhinavxd",
    "name": "libredesk",
    "url": "https://github.com/abhinavxd/libredesk"
  },
  "compose_check": {
    "status": "config_ok",
    "validated_at": "2026-10-22",
    "summary": "config_ok on 2026-10-22"
  },
  "recipe": {
    "version": 1,
    "source_path": "docker-compose.yml",
    "source_repo": "abhinavxd/libredesk",
    "source_commit_sha": "5668a2a2c503b9304404d8f3620131b2990cbb99",
    "source_kind": "app_repo",
    "source_url": "https://github.com/abhinavxd/libredesk/blob/5668a2a2c503b9304404d8f3620131b2990cbb99/docker-compose.yml"
  },
  "install_steps": [
    {
      "order": 1,
      "kind": "prerequisite",
      "language": "text",
      "label": "Docker with the Compose plugin and git",
      "body": "A host with Docker, the Docker Compose plugin and git. This entry needs a checkout of the project repository.",
      "source_url": "https://github.com/abhinavxd/libredesk/blob/5668a2a2c503b9304404d8f3620131b2990cbb99/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 2,
      "kind": "shell",
      "language": "bash",
      "label": "Get the source at commit 5668a2a",
      "body": "git init libredesk\ncd libredesk\ngit remote add origin https://github.com/abhinavxd/libredesk.git\ngit fetch --depth 1 origin 5668a2a2c503b9304404d8f3620131b2990cbb99\ngit checkout FETCH_HEAD",
      "source_url": "https://github.com/abhinavxd/libredesk/blob/5668a2a2c503b9304404d8f3620131b2990cbb99/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 3,
      "kind": "compose",
      "language": "yaml",
      "label": "The compose file in the checkout: docker-compose.yml (shown here for reading)",
      "body": "services:\n  # Libredesk app\n  app:\n    image: libredesk/libredesk:latest\n    container_name: libredesk_app\n    restart: unless-stopped\n    ports:\n      - \"9000:9000\"\n    environment:\n      # If the password is set during first docker-compose up, the system user password will be set to this value.\n      # You can always set system user password later by running `docker exec -it libredesk_app ./libredesk --set-system-user-password`.\n      LIBREDESK_SYSTEM_USER_PASSWORD: ${LIBREDESK_SYSTEM_USER_PASSWORD:-}\n    networks:\n      - libredesk\n    depends_on:\n      - db\n      - redis\n    volumes:\n      - ./uploads:/libredesk/uploads:rw \n      - ./config.toml:/libredesk/config.toml\n    command: [sh, -c, \"./libredesk --install --idempotent-install --yes --config /libredesk/config.toml && ./libredesk --upgrade --yes --config /libredesk/config.toml && ./libredesk --config /libredesk/config.toml\"]\n\n  # PostgreSQL database\n  db:\n    image: postgres:17-alpine\n    container_name: libredesk_db\n    restart: unless-stopped\n    networks:\n      - libredesk\n    ports:\n      # Only bind on the local interface. To connect to Postgres externally, change this to 0.0.0.0\n      - \"127.0.0.1:5432:5432\"\n    environment:\n      # Set these environment variables to configure the database, defaults to libredesk.\n      POSTGRES_USER: ${POSTGRES_USER:-libredesk}\n      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-libredesk} \n      POSTGRES_DB: ${POSTGRES_DB:-libredesk}\n    healthcheck:\n      test: [\"CMD-SHELL\", \"pg_isready -U ${POSTGRES_USER:-libredesk} -d ${POSTGRES_DB:-libredesk}\"]\n      interval: 10s\n      timeout: 5s\n      retries: 6\n    volumes:\n      - postgres-data:/var/lib/postgresql/data\n\n  # Redis\n  redis:\n    image: redis:7-alpine\n    container_name: libredesk_redis\n    restart: unless-stopped\n    ports:\n      # Only bind on the local interface.\n      - \"127.0.0.1:6379:6379\"\n    networks:\n      - libredesk\n    volumes:\n      - redis-data:/data\n\nnetworks:\n  libredesk:\n\nvolumes:\n  postgres-data:\n  redis-data:\n",
      "source_url": "https://github.com/abhinavxd/libredesk/blob/5668a2a2c503b9304404d8f3620131b2990cbb99/docker-compose.yml",
      "validation_status": "config_ok"
    },
    {
      "order": 4,
      "kind": "shell",
      "language": "bash",
      "label": "Copy config.sample.toml to config.toml",
      "body": "cp config.sample.toml config.toml",
      "source_url": "https://github.com/abhinavxd/libredesk/blob/5668a2a2c503b9304404d8f3620131b2990cbb99/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 5,
      "kind": "note",
      "language": "text",
      "label": "What the compose file check ran with",
      "body": "The compose file check ran in a checkout of abhinavxd/libredesk at 5668a2a2c503b9304404d8f3620131b2990cbb99 (a sparse checkout: only the top-level files), after config.sample.toml was copied to config.toml. The README tells the reader to download docker-compose.yml and config.sample.toml, copy the sample to config.toml, edit it and run docker compose up -d.",
      "source_url": "https://github.com/abhinavxd/libredesk/blob/5668a2a2c503b9304404d8f3620131b2990cbb99/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 6,
      "kind": "shell",
      "language": "bash",
      "label": "Start it",
      "body": "docker compose up -d",
      "source_url": "https://github.com/abhinavxd/libredesk/blob/5668a2a2c503b9304404d8f3620131b2990cbb99/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 7,
      "kind": "verify",
      "language": "text",
      "label": "Open the app",
      "body": "Open http://localhost:9000. The compose file publishes host port 9000 for the app service. The README says to open this address and log in as the System user.",
      "source_url": "https://github.com/abhinavxd/libredesk/blob/5668a2a2c503b9304404d8f3620131b2990cbb99/docker-compose.yml",
      "validation_status": "unvalidated"
    }
  ],
  "notes": [
    {
      "kind": "gotcha",
      "title": "Some images use the latest tag or no tag",
      "body": "Images without a pinned version: app: libredesk/libredesk:latest. A later pull can get a different version.",
      "source_url": "https://github.com/abhinavxd/libredesk/blob/5668a2a2c503b9304404d8f3620131b2990cbb99/docker-compose.yml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file publishes host ports",
      "body": "Host ports: 9000 (app), 127.0.0.1:5432 (db), 127.0.0.1:6379 (redis). A port without a host address listens on all host network interfaces.",
      "source_url": "https://github.com/abhinavxd/libredesk/blob/5668a2a2c503b9304404d8f3620131b2990cbb99/docker-compose.yml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file mounts host folders",
      "body": "Host paths mounted into containers: ./uploads at /libredesk/uploads (app), ./config.toml at /libredesk/config.toml (app).",
      "source_url": "https://github.com/abhinavxd/libredesk/blob/5668a2a2c503b9304404d8f3620131b2990cbb99/docker-compose.yml",
      "checked_at": "2026-10-22"
    }
  ],
  "signals": {
    "captured_at": "2026-10-22",
    "stars": 3062,
    "forks": 320,
    "open_issues": 120,
    "last_push": "2026-10-22",
    "days_since_push": 0,
    "latest_release": "v2.9.0",
    "latest_release_date": "2026-10-22",
    "days_since_release": 0
  },
  "links": {
    "html": "https://openlogs.fyi/tools/libredesk",
    "markdown": "https://openlogs.fyi/tools/libredesk.md",
    "json": "https://openlogs.fyi/tools/libredesk.json"
  },
  "updated_at": "2026-10-22"
}