# Altinity/clickhouse-backup

Tool for easy backup and restore for ClickHouse® using object storage for backup files.

Repository: https://github.com/Altinity/clickhouse-backup
Canonical: https://ross.abutalabs.com/products/clickhouse-backup
Homepage: https://altinity.com
Language: Go
License: NOASSERTION
License Family: other
Topics: clickhouse, backup, s3, dump, clickhouse-backup, clickhousedump, azblob, ftp, gcs, sftp
Last push: 2026-08-26T15:36:14+00:00

## Health v2 (maintenance only)
Score: 97/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 93, longevity 100
- inputs: {"age_days": 2898, "days_push": 7, "days_rel": 48, "gap_med": 5, "n_releases_24m": 50}
- flags: no_license, no_readme
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1638, forks 275 (observed 2026-08-28T04:05:15.078547+00:00)

## What it is
A Go CLI tool for backing up and restoring ClickHouse databases, uploading backup files to object storage such as S3, GCS, Azure Blob, SFTP, and FTP. Maintained by Altinity as part of its open-source ClickHouse tooling.

## Use cases
- back up clickhouse database to s3
- restore clickhouse from backup
- schedule clickhouse backups to object storage
- disaster recovery for clickhouse cluster
- copy clickhouse backups to gcs or azure blob
- clickhouse backup over sftp

## When to choose
- you run self-managed ClickHouse and need reliable backup/restore to cloud object storage
- you want a mature, actively maintained tool from the leading ClickHouse services vendor
- you need multiple storage backends (S3, GCS, Azure, SFTP, FTP) in one tool

## When to avoid
- you use a managed ClickHouse service that already provides built-in backups
- you need backups for databases other than ClickHouse
- you want a GUI-based backup solution

## Facets
- artifact type: cli-tool
- maturity: active
- function: backup, database, cli, developer-tools
- domain: databases, self-hosted
- platform: go, self-hosted
- tags: clickhouse, s3, gcs, azure-blob, sftp, ftp, disaster-recovery, object-storage, devops, data-engineering, linux, macos, docker, kubernetes

## Member repositories
- Altinity/clickhouse-backup (main) score 97

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:15.078547+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:46:32.135810+00:00, confidence not recorded.
  - homepage: https://altinity.com (fetched 2026-08-29T11:20:05.201473+00:00, sha 2e4483f77935)
  - site_page: https://altinity.com/plans-and-features-clickhouse (fetched 2026-08-29T11:20:05.209379+00:00, sha a950c948bc23)
  - site_page: https://docs.altinity.com/ (fetched 2026-08-29T11:20:05.211805+00:00, sha bbc62ad56f59)
  - site_page: https://altinity.com/about-us (fetched 2026-08-29T11:20:05.213968+00:00, sha d669631e5337)
  - site_page: https://altinity.com/about-us/press-releases (fetched 2026-08-29T11:20:05.216468+00:00, sha 15df8a7b40d5)
  - site_page: https://docs.altinity.com (fetched 2026-08-29T11:20:05.219837+00:00, sha bbc62ad56f59)
  - site_page: https://altinity.com/altinity-cloud-vs-clickhouse-cloud-faq (fetched 2026-08-29T11:20:05.204962+00:00, sha bb53d77d30e7)
  - site_page: https://altinity.com/clickhouse-pricing (fetched 2026-08-29T11:20:05.207310+00:00, sha 871afe6f1224)
  - site_page: https://altinity.com/releases (fetched 2026-08-29T11:20:05.222062+00:00, sha 8cc06471b7c9)
- Data as of 2026-08-30T08:39:29.467469+00:00.