Files
Auto_Bangumi/docs/en/deploy/docker-compose.md
Estrella Pan b129c4437a chore(release): 准备 4.0.0
- 部署文档、升级指南与 README 改为正式版说法:latest = 4.0,3.3 固定为 3.3.7
- docs/changelog/4.0.md 新增 4.0.0 汇总(升级前必读、破坏性变更、新功能、主要修复),链接改为绝对地址
- 文档站与插件市场改为从 main 发布,插件上架 PR 的目标分支改为 main
- 文档站页脚版本 v4.0.0;en/ja README 的 star history 地址
2026-10-24 11:46:50 +02:00

2.5 KiB

Deploy with Docker Compose

A one-click deployment method for AutoBangumi using a docker-compose.yml file.

::: tip Upgrade from 3.3 The commands on this page use the latest tag, which installs the 4.0 stable release. If you use 3.3 now, read Upgrade from 3.3 to 4.0 before you pull the new image. To stay on 3.3, set the tag to 3.3.7. The 4.0 hard link plugin also needs the media library directory mounted into the container. Refer to Bangumi Manager. :::

Install Docker Compose

Docker Compose usually comes bundled with Docker. Check with:

docker compose -v

If not installed, install it with:

$ sudo apt-get update
$ sudo apt-get install docker-compose-plugin

Deploy AutoBangumi

Create AutoBangumi and Data Directories

mkdir -p ${HOME}/AutoBangumi/{config,data}
cd ${HOME}/AutoBangumi

Option 1: Custom Docker Compose Configuration

version: "3.8"

services:
  AutoBangumi:
    image: "ghcr.io/estrellaxd/auto_bangumi:latest"
    container_name: AutoBangumi
    volumes:
      - ./config:/app/config
      - ./data:/app/data
    ports:
      - "7892:7892"
    restart: unless-stopped
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"
    dns:
      - 8.8.8.8
    network_mode: bridge
    environment:
      - TZ=Asia/Shanghai
      - PGID=$(id -g)
      - PUID=$(id -u)
      - UMASK=022

Copy the above content into a docker-compose.yml file.

Option 2: Download Docker Compose Configuration File

If you don't want to create the docker-compose.yml file manually, the project provides pre-made configurations:

  • Install AutoBangumi only:
    wget https://raw.githubusercontent.com/EstrellaXD/Auto_Bangumi/main/docs/resource/docker-compose/AutoBangumi/docker-compose.yml
    
  • Install qBittorrent and AutoBangumi:
    wget https://raw.githubusercontent.com/EstrellaXD/Auto_Bangumi/main/docs/resource/docker-compose/qBittorrent+AutoBangumi/docker-compose.yml
    

Choose your installation method and run the command to download the docker-compose.yml file. You can customize parameters with a text editor if needed.

Define Environment Variables

If you're using the downloaded AB+QB Docker Compose file, you need to define the following environment variables:

export \
QB_PORT=<YOUR_PORT>
  • QB_PORT: Enter your existing qBittorrent port or your desired custom port, e.g., 8080

Start Docker Compose

docker compose up -d