teyker/yagpdb repository overview

⁠Teyloll's YAGPDB image

⁠THIS IS AN ABRIDGED README

For more information, visit the source code⁠

⁠NOTE (Breaking changes)

• Please read the section Switching from other pre-built images carefully if you're switching from the official caskd/yagpdb image.
• The repository teyker/arm64-base is no longer available. If you followed a previous version of this guide and are pulling any version-specific ARM64 tags older than v1.24.18, please note that the base image will NOT receive any updates, including security patches. I would recommend switching to the latest tag.
• Since March 13, 2026, rootless* images have switched to Docker Hardened Images⁠ for added security. Default user has also been changed from yagpdbbot:yagpdbbot(1000:1000) to nonroot:nonroot(65532:65532).
• devel* tags has been discontinued to avoid being confused with "delve" (go debugger). Use master* (master/main branch) or dev* (dev branch) instead.

⁠Tags

⁠Setup

You'll only need 3 files: app.env, db.env, and docker-compose.yml. Download example files from my git or the official one, tweak the settings, put them in the same folder, and docker-compose up -d.

NOTE: This bot requires privileged intents. Please go to Discord Developer Portal⁠ and enable "Presence Intent", "Server Members Intent" and "Message Content Intent" all three intents under "Privileged Gateway Intents" for your bot.

⁠Switching from Other Pre-built Images

Edit your docker-compose.yml file

services:
  app:
    image: teyker/yagpdb # Change image name here
    restart: unless-stopped
    command:
      - "/app/yagpdb" # This line is optional but recommended
      - "-all"
      - "-pa"
      - "-exthttps=false" # Example, edit extra flags as needed here
      - "-https=true" # Example, edit extra flags as needed here

Or use mine as reference: https://dev.azure.com/brutalbot/_git/yagpdb-public?path=/example-files⁠

If you're switching from caskd/yagpdb, please go to Discord Developer Portal⁠ and enable both "Presence Intent" and "Server Members Intent" under "Privileged Gateway Intents" for your bot.

You are unlikely to lose any configuration or data during the switch. But for safety, always make a backup of your volumes before any operations. Switching to an older image (downgrading) may lead to unexpected behavior or data loss. Check the breaking_changes.md⁠ for compatibility changes.

⁠Hosting on Raspberry Pi (or Other ARM Machines)

The default tags (the latest and the version tag) contain multi-arch images. Follow the steps in the Setup section and select the tag of your choice. If you followed a previous version of this README and pulling tags with "-arm64" suffix, don't worry, they're still there and will be updated as before.

YAGPDB requires 64-bit OS. Only the following Raspberry Pi models have 64-bit CPU and are supported:

• Raspberry Pi 2 Model B v1.2
• Raspberry Pi 3 and newer (all models)
• Compute Module 3 and newer (all models, including Lite)
• Raspberry Pi Zero 2 W
• Raspberry Pi 400

Raspberry Pi OS (64-bit) is compatible with the following models: 3B, 3B+, 3A+, 4, 400, CM3, CM3+, CM4, Zero 2 W. However, if you installed Raspberry Pi OS (previously called Raspbian) before February 2nd, 2022, you might still need to manually switch to 64-bit kernel. Search "Raspberry Pi OS 64-bit kernel" on the Internet for more info.

⁠Update Frequency, Retention Time & Deprecation Notice

The images are updated daily during 02:30 AM to 03:00 AM UTC.

• latest/<version number> are built using code tagged with the latest release⁠. Even though it's less secure (comapring to rootless builds), this tag is probably what you want.
• Tags matching ^v[0-9]+\.[0-9]+\.[0-9]+$ (aka <version number>) are immutable and will not be updated once published.
• master a using code from the master branch of YAGPDB repo.
• *-rootless images are built for rootless Docker deployment (increased safety). These images are based on Docker Hardened Images⁠ for added security.
• *-debug images have go toolchain & go-delve pre-installed. Again, these images are less secure. Only use this tag if you know what you're doing.

I currently have no intention of deprecating this repository anytime soon, and I will be giving notices 30 days before the discontinuation both in README and in YAGPDB's official Discord server.

⁠Help & Bug Reports

Please contact the bot's maintainer Botlabs for everything about the bot itself. For bug reports about this repo, please ping teyloll in the #self-hosting-discussion channel over on YAGPDB Community & Support Discord server.

⁠Disclaimers

• Since commit a6f292a4c2d3c8aabc9e676e061ab6261fb438a0, parts of this project were written with the help of generative AI. All content has been reviewed, edited, and tested by me to ensure accuracy, security, and alignment with the project's goals.
• The Docker images are provided "AS IS" under the MIT License. While I strive to keep builds secure and timely, I cannot warrant against supply chain attacks (upstream compromises, infrastructure breaches, or malicious dependencies) or guarantee the software is defect-free. Use at your own risk.

⁠Links

Official git (Original bot): https://github.com/botlabs-gg/yagpdb⁠

My git (Extra code used for generating this image): https://dev.azure.com/brutalbot/yagpdb-public⁠

⁠License

⁠Files copied from YAGPDB's repo

MIT License Copyright (c) 2019 jonas747 https://raw.githubusercontent.com/botlabs-gg/yagpdb/master/LICENSE⁠

The license above applies to the following files in this repo:

• app.example.env
• db.example.env

⁠Files based on other's work

⁠YAGPDB

MIT License Copyright (c) 2026 Teyloll https://dev.azure.com/brutalbot/_git/yagpdb-public?path=%2FLICENCE⁠

The license above applies to the following files in this repo:

• docker-compose.*.yml

⁠Pipeline files

MIT License Copyright (c) 2026 Teyloll https://dev.azure.com/brutalbot/_git/yagpdb-public?path=%2FLICENCE⁠

The license above applies to the following files in this repo:

• flavor-file directory
• pipelines directory

⁠Documentation & Wiki

Teyloll's YAGPDB Hosting Guide (c) 2026 by Teyloll Teyloll's YAGPDB Hosting Guide is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License. You should have received a copy of the license along with this work. If not, see http://creativecommons.org/licenses/by-nc/4.0/⁠.

The license above applies to the following files in this repo:

• Wiki branch
• FAQ section in README.md

⁠Footnotes

1. For more information, see Rootless mode | Docker Docs⁠ ↩⁠

2. These images are based on golang-alpine with delve installed. Be warned these images are huge in size, run less efficiently, and are less secure than the default images. Use at your own risk. ↩⁠