{
  "schema_version": 1,
  "generated_at": "2026-10-22T00:00:00.000Z",
  "canonical_url": "https://openlogs.fyi/tools/seaweedfs",
  "slug": "seaweedfs",
  "name": "SeaweedFS",
  "tagline": "Distributed file store with S3, WebDAV and filer interfaces.",
  "replaces": {
    "summary": "Paid object storage services, such as Amazon S3.",
    "products": [
      {
        "slug": "amazon-s3",
        "name": "Amazon S3",
        "vendor": "Amazon",
        "url": "https://openlogs.fyi/alternatives/amazon-s3"
      }
    ]
  },
  "stack": [
    {
      "kind": "language",
      "name": "Go"
    }
  ],
  "deployment_methods": [
    "docker_compose"
  ],
  "requirements": {
    "min_ram_mb": null,
    "min_cpu_cores": null,
    "source_url": null
  },
  "license": {
    "spdx": "Apache-2.0",
    "class": "osi",
    "source_url": "https://github.com/seaweedfs/seaweedfs/blob/82f0a825641e20948868ae01f9fd3325ff0424ac/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/seaweedfs/seaweedfs/blob/82f0a825641e20948868ae01f9fd3325ff0424ac/README.md",
    "checked_at": "2026-10-22"
  },
  "difficulty": {
    "value": "medium",
    "reason": "6 services, 1 volume mount, no env values to set, no elevated host access. Heuristic score 3 of 11: medium."
  },
  "repository": {
    "owner": "seaweedfs",
    "name": "seaweedfs",
    "url": "https://github.com/seaweedfs/seaweedfs"
  },
  "compose_check": {
    "status": "config_ok",
    "validated_at": "2026-10-22",
    "summary": "config_ok on 2026-10-22"
  },
  "recipe": {
    "version": 1,
    "source_path": "docker/seaweedfs-compose.yml",
    "source_repo": "seaweedfs/seaweedfs",
    "source_commit_sha": "82f0a825641e20948868ae01f9fd3325ff0424ac",
    "source_kind": "app_repo",
    "source_url": "https://github.com/seaweedfs/seaweedfs/blob/82f0a825641e20948868ae01f9fd3325ff0424ac/docker/seaweedfs-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/seaweedfs/seaweedfs/blob/82f0a825641e20948868ae01f9fd3325ff0424ac/docker/seaweedfs-compose.yml",
      "validation_status": "unvalidated"
    },
    {
      "order": 2,
      "kind": "compose",
      "language": "yaml",
      "label": "Save the compose file as compose.yaml",
      "body": "version: '3.9'\n\nservices:\n  master:\n    image: chrislusf/seaweedfs # use a remote image\n    ports:\n      - 9333:9333\n      - 19333:19333\n      - 9324:9324\n    command: 'master -ip=master -ip.bind=0.0.0.0 -metricsPort=9324'\n  volume:\n    image: chrislusf/seaweedfs # use a remote image\n    ports:\n      - 8080:8080\n      - 18080:18080\n      - 9325:9325\n    command: 'volume -ip=volume -master=\"master:9333\" -ip.bind=0.0.0.0 -port=8080 -metricsPort=9325'\n    depends_on:\n      - master\n  filer:\n    image: chrislusf/seaweedfs # use a remote image\n    ports:\n      - 8888:8888\n      - 18888:18888\n      - 9326:9326\n    command: 'filer -ip=filer -master=\"master:9333\" -ip.bind=0.0.0.0 -metricsPort=9326'\n    tty: true\n    stdin_open: true\n    depends_on:\n      - master\n      - volume\n  s3:\n    image: chrislusf/seaweedfs # use a remote image\n    ports:\n      - 8333:8333\n      - 9327:9327\n    command: 's3 -filer=\"filer:8888\" -ip.bind=0.0.0.0 -metricsPort=9327'\n    depends_on:\n      - master\n      - volume\n      - filer\n  webdav:\n    image: chrislusf/seaweedfs # use a remote image\n    ports:\n      - 7333:7333\n    command: 'webdav -filer=\"filer:8888\"'\n    depends_on:\n      - master\n      - volume\n      - filer\n  prometheus:\n    image: prom/prometheus:v2.21.0\n    ports:\n      - 9000:9090\n    volumes:\n      - ./prometheus:/etc/prometheus\n    command: '--web.enable-lifecycle --config.file=/etc/prometheus/prometheus.yml'\n    depends_on:\n      - s3\n",
      "source_url": "https://github.com/seaweedfs/seaweedfs/blob/82f0a825641e20948868ae01f9fd3325ff0424ac/docker/seaweedfs-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/seaweedfs/seaweedfs/blob/82f0a825641e20948868ae01f9fd3325ff0424ac/docker/seaweedfs-compose.yml",
      "validation_status": "unvalidated"
    },
    {
      "order": 4,
      "kind": "verify",
      "language": "text",
      "label": "Open the app",
      "body": "Open http://localhost:8888. The compose file publishes host port 8888 for the filer service.",
      "source_url": "https://github.com/seaweedfs/seaweedfs/blob/82f0a825641e20948868ae01f9fd3325ff0424ac/docker/seaweedfs-compose.yml",
      "validation_status": "unvalidated"
    }
  ],
  "notes": [
    {
      "kind": "gotcha",
      "title": "Some images use the latest tag or no tag",
      "body": "Images without a pinned version: master: chrislusf/seaweedfs (no tag), volume: chrislusf/seaweedfs (no tag), filer: chrislusf/seaweedfs (no tag), s3: chrislusf/seaweedfs (no tag), webdav: chrislusf/seaweedfs (no tag). A later pull can get a different version.",
      "source_url": "https://github.com/seaweedfs/seaweedfs/blob/82f0a825641e20948868ae01f9fd3325ff0424ac/docker/seaweedfs-compose.yml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file publishes host ports",
      "body": "Host ports: 9333 (master), 19333 (master), 9324 (master), 8080 (volume), 18080 (volume), 9325 (volume), 8888 (filer), 18888 (filer) and 5 more. A port without a host address listens on all host network interfaces.",
      "source_url": "https://github.com/seaweedfs/seaweedfs/blob/82f0a825641e20948868ae01f9fd3325ff0424ac/docker/seaweedfs-compose.yml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file mounts host folders",
      "body": "Host paths mounted into containers: ./prometheus at /etc/prometheus (prometheus).",
      "source_url": "https://github.com/seaweedfs/seaweedfs/blob/82f0a825641e20948868ae01f9fd3325ff0424ac/docker/seaweedfs-compose.yml",
      "checked_at": "2026-10-22"
    }
  ],
  "signals": {
    "captured_at": "2026-10-22",
    "stars": 35668,
    "forks": 3085,
    "open_issues": 729,
    "last_push": "2026-10-22",
    "days_since_push": 0,
    "latest_release": "4.48",
    "latest_release_date": "2026-09-28",
    "days_since_release": 23
  },
  "links": {
    "html": "https://openlogs.fyi/tools/seaweedfs",
    "markdown": "https://openlogs.fyi/tools/seaweedfs.md",
    "json": "https://openlogs.fyi/tools/seaweedfs.json"
  },
  "updated_at": "2026-10-22"
}