Download dbbot

dbbot is distributed through a single GitHub repository and a single distribution package, which contains MySQL, ClickHouse and monitoring related subdirectories.

Applicable scenarios: production environment, offline installation, version traceability.

Download the release asset dbbot-${dbbot_version}.tar.gz instead of the default GitHub Source code (tar.gz/zip) archives. Those source archives are for code inspection and development, not as the direct deployment input for this guide.

dbbot_version="$(basename "$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/fanderchan/dbbot/releases/latest)")"
wget "https://github.com/fanderchan/dbbot/releases/download/${dbbot_version}/dbbot-${dbbot_version}.tar.gz"
tar -zxvf "dbbot-${dbbot_version}.tar.gz" -C /usr/local/

For reproducible installations, replace releases/latest with a fixed tag or set dbbot_version manually. Release page: https://github.com/fanderchan/dbbot/releases

Common directories after decompression:

  • bin/dbbotctl
  • mysql_ansible
  • clickhouse_ansible
  • monitoring_prometheus_ansible
  • portable-ansible-v0.5.0-py3

The curated release package also includes the control-host CLI dbbotctl. After extracting to /usr/local/dbbot, it is recommended to validate the local environment before running playbooks:

/usr/local/dbbot/bin/dbbotctl version
/usr/local/dbbot/bin/dbbotctl doctor

For later release-package upgrades, use dbbotctl release upgrade instead of deleting and restoring the dbbot directory manually. Detailed workflow: dbbot Upgrade and Rollback.

Method 2: Clone the source code repository

If you need the full repository, use git clone directly instead of treating the GitHub Source code archive as the managed release package.

Applicable scenarios: Experience new features in advance, track repairs, and participate in collaboration.

cd /usr/local
git clone https://github.com/fanderchan/dbbot
cd dbbot

It is recommended to switch to the corresponding branch or tag according to your actual environment before using it.

Next chapter: Deploy dbbot and configure Ansible