{
  "schema_version": 1,
  "generated_at": "2026-10-22T00:00:00.000Z",
  "canonical_url": "https://openlogs.fyi/tools/audiobookshelf",
  "slug": "audiobookshelf",
  "name": "Audiobookshelf",
  "tagline": "Server for audiobooks and podcasts with a web player and mobile apps.",
  "replaces": {
    "summary": "Paid audiobook services, such as Audible.",
    "products": [
      {
        "slug": "audible",
        "name": "Audible",
        "vendor": "Amazon",
        "url": "https://openlogs.fyi/alternatives/audible"
      }
    ]
  },
  "stack": [
    {
      "kind": "language",
      "name": "JavaScript"
    }
  ],
  "deployment_methods": [
    "docker_compose"
  ],
  "requirements": {
    "min_ram_mb": null,
    "min_cpu_cores": null,
    "source_url": null
  },
  "license": {
    "spdx": "GPL-3.0",
    "class": "osi",
    "source_url": "https://github.com/advplyr/audiobookshelf/blob/743d9152208507a1dbf7c95c94290071338f44bd/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/advplyr/audiobookshelf/blob/743d9152208507a1dbf7c95c94290071338f44bd/readme.md",
    "checked_at": "2026-10-22"
  },
  "difficulty": {
    "value": "easy",
    "reason": "1 service, 4 volume mounts, no env values to set, no elevated host access. Heuristic score 2 of 11: easy."
  },
  "repository": {
    "owner": "advplyr",
    "name": "audiobookshelf",
    "url": "https://github.com/advplyr/audiobookshelf"
  },
  "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": "advplyr/audiobookshelf",
    "source_commit_sha": "743d9152208507a1dbf7c95c94290071338f44bd",
    "source_kind": "app_repo",
    "source_url": "https://github.com/advplyr/audiobookshelf/blob/743d9152208507a1dbf7c95c94290071338f44bd/docker-compose.yml"
  },
  "install_steps": [
    {
      "order": 1,
      "kind": "prerequisite",
      "language": "text",
      "label": "Docker with the Compose plugin",
      "body": "A host with Docker and the Docker Compose plugin. This entry runs from a compose file.",
      "source_url": "https://github.com/advplyr/audiobookshelf/blob/743d9152208507a1dbf7c95c94290071338f44bd/docker-compose.yml",
      "validation_status": "unvalidated"
    },
    {
      "order": 2,
      "kind": "compose",
      "language": "yaml",
      "label": "Save the compose file as docker-compose.yml",
      "body": "### EXAMPLE DOCKER COMPOSE ###\nservices:\n  audiobookshelf:\n    image: ghcr.io/advplyr/audiobookshelf:latest\n    # ABS runs on port 13378 by default. If you want to change\n    # the port, only change the external port, not the internal port\n    ports:\n      - 13378:80\n    volumes:\n      # These volumes are needed to keep your library persistent\n      # and allow media to be accessed by the ABS server.\n      # The path to the left of the colon is the path on your computer,\n      # and the path to the right of the colon is where the data is\n      # available to ABS in Docker.\n      # You can change these media directories or add as many as you want\n      - ./audiobooks:/audiobooks\n      - ./podcasts:/podcasts\n      # The metadata directory can be stored anywhere on your computer\n      - ./metadata:/metadata\n      # The config directory needs to be on the same physical machine\n      # you are running ABS on\n      - ./config:/config\n    restart: unless-stopped\n    # You can use the following user directive to run the ABS\n    # docker container as a specific user. You will need to change\n    # the UID and GID to the correct values for your user.\n    # user: 1000:1000\n",
      "source_url": "https://github.com/advplyr/audiobookshelf/blob/743d9152208507a1dbf7c95c94290071338f44bd/docker-compose.yml",
      "validation_status": "config_ok"
    },
    {
      "order": 3,
      "kind": "shell",
      "language": "bash",
      "label": "Start it",
      "body": "docker compose up -d",
      "source_url": "https://github.com/advplyr/audiobookshelf/blob/743d9152208507a1dbf7c95c94290071338f44bd/docker-compose.yml",
      "validation_status": "unvalidated"
    },
    {
      "order": 4,
      "kind": "verify",
      "language": "text",
      "label": "Open the app",
      "body": "Open http://localhost:13378. The compose file publishes host port 13378 for the audiobookshelf service.",
      "source_url": "https://github.com/advplyr/audiobookshelf/blob/743d9152208507a1dbf7c95c94290071338f44bd/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: audiobookshelf: ghcr.io/advplyr/audiobookshelf:latest. A later pull can get a different version.",
      "source_url": "https://github.com/advplyr/audiobookshelf/blob/743d9152208507a1dbf7c95c94290071338f44bd/docker-compose.yml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file publishes host ports",
      "body": "Host ports: 13378 (audiobookshelf). A port without a host address listens on all host network interfaces.",
      "source_url": "https://github.com/advplyr/audiobookshelf/blob/743d9152208507a1dbf7c95c94290071338f44bd/docker-compose.yml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file mounts host folders",
      "body": "Host paths mounted into containers: ./audiobooks at /audiobooks (audiobookshelf), ./podcasts at /podcasts (audiobookshelf), ./metadata at /metadata (audiobookshelf), ./config at /config (audiobookshelf).",
      "source_url": "https://github.com/advplyr/audiobookshelf/blob/743d9152208507a1dbf7c95c94290071338f44bd/docker-compose.yml",
      "checked_at": "2026-10-22"
    }
  ],
  "signals": {
    "captured_at": "2026-10-22",
    "stars": 14739,
    "forks": 1228,
    "open_issues": 1241,
    "last_push": "2026-10-05",
    "days_since_push": 16,
    "latest_release": "v2.37.1",
    "latest_release_date": "2026-09-29",
    "days_since_release": 22
  },
  "links": {
    "html": "https://openlogs.fyi/tools/audiobookshelf",
    "markdown": "https://openlogs.fyi/tools/audiobookshelf.md",
    "json": "https://openlogs.fyi/tools/audiobookshelf.json"
  },
  "updated_at": "2026-10-22"
}