Skip to main content

Build Testing Pypi

What is this?

Backup tool for PowerDNS database (MySQL) to local or S3 storage in bind format. Open metrics are also computed on your feched zones.

PyPI

python 3.14.x python 3.13.x python 3.12.x python 3.11.x

Deploy the pdnsbackup tool in your server with the pip command.

pip install pdnsbackup

Usage

After installation, you can execute the pdnsbackup to start-it.

$ pdnsbackup -h
usage: -c [-h] [-c C] [-e E] [-v]

options:
  -h, --help  show this help message and exit
  -c C        external config file
  -e E        env config file
  -v          debug mode

Configuration

This tool can be configurated with severals ways. See the default config file:

  • from external configuration file (-c config argument)

  • from environment variables (-e env file argument)

Variables Description
PDNSBACKUP_DEBUG debug mode 1 or 0
PDNSBACKUP_GMYSQL_ENABLED set to 1 to enable gmysql backend, enabled by default
PDNSBACKUP_GMYSQL_HOST mysql port, default is 127.0.0.1
PDNSBACKUP_GMYSQL_PORT mysql port, default is 3306
PDNSBACKUP_GMYSQL_SSL enable ssl, default is 0
PDNSBACKUP_GMYSQL_DBNAME mysql database name
PDNSBACKUP_GMYSQL_USER mysql user
PDNSBACKUP_GMYSQL_PASSWORD mysql password
PDNSBACKUP_FILE_ENABLED set to 1 enable backup to file, enabled by default
PDNSBACKUP_FILE_PATH_BIND zone bind path in named.conf
PDNSBACKUP_FILE_PATH_OUTPUT output folder of the export
PDNSBACKUP_S3_ENABLED set to 1 enable backup to S3 storage, disabled by default
PDNSBACKUP_S3_ENDPOINT_URL your s3 url
PDNSBACKUP_S3_SSL_VERIFY disable ssl verify
PDNSBACKUP_S3_ACCESS_KEY_ID your access key
PDNSBACKUP_S3_SECRET_ACCESS_KEY your secret access key
PDNSBACKUP_S3_BUCKET_NAME bucket name
PDNSBACKUP_S3_BACKUP_FILE backup file name
PDNSBACKUP_S3_BACKUP_DELETE_OLDER delete backups older than xx days
PDNSBACKUP_METRICS_ENABLED export open metrics
PDNSBACKUP_METRICS_PROM_FILE write metrics to file path

Metrics

This tool can be used to compute statistics on your DNS records.

Variables Description
pdnsbackup_status Status of the backup process
pdnsbackup_zones_total Total number of zones
pdnsbackup_zones_empty_total Total number of empty zones
pdnsbackup_records_total Total number of records per DNS zones
pdnsbackup_wildcards_total Total number of DNS wilcards
pdnsbackup_delegations_total Total number of DNS delegations
pdnsbackup_rrtypes_total Total number of records per type (A, AAAA, CNAME, ...)

Docker run

sudo docker run --rm --env-file ./.env --name=pdnsbackup dmachard/pdnsbackup:latest

Run from source

Create a .env file to populate your variable

Create a virtualenv

python -m venv venv
source venv/bin/activate

Install requirements and run-it

python3 -m pip install -r requirements.txt
python3 -c "import pdnsbackup; pdnsbackup.run();"
python3 -c "import pdnsbackup; pdnsbackup.run();" -c tests/config.yml
python3 -c "import pdnsbackup; pdnsbackup.run();" -e tests/.env

Build and run from docker image

sudo docker build . --file Dockerfile -t pdnsbackup

Run tests

powerdns auth 5.0.x powerdns auth 4.9.x powerdns auth 4.8.x

Run all tests

python -m unittest discover -v tests/

Run one by one

python -m unittest -v tests.test_config
python -m unittest -v tests.test_parser
python -m unittest -v tests.test_import
python -m unittest -v tests.test_export_file
python -m unittest -v tests.test_export_metrics

Metadata

Release files for pdnsbackup 1.0.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pdnsbackup 1.0.13
File Size Uploaded Provenance Actions
pdnsbackup-1.0.13.tar.gz 13.4 kB With provenance Details for pdnsbackup-1.0.13.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pdnsbackup 1.0.13
File Interpreter ABI Platform Actions
pdnsbackup-1.0.13-py3-none-any.whl Python 3 none any Details for pdnsbackup-1.0.13-py3-none-any.whl

Total release size: 23.9 kB

Release files / pdnsbackup-1.0.13.tar.gz

Download URL pdnsbackup-1.0.13.tar.gz
Size 13.4 kB
Tags Source
SHA-256 checksum
How to use checksums
0e0b086124a8cca8495e278494afdbd126eb1d1babc954a28015459b26294508
BLAKE2b-256 checksum
How to use checksums
d63153849defcf63070964c78198ba771efb608ffcbb3991b8899a97062b7205
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / pdnsbackup-1.0.13-py3-none-any.whl

Download URL pdnsbackup-1.0.13-py3-none-any.whl
Size 10.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a70655f9c4db4cd9c457b004d1dfd91ecdb4d21563483cf5fff41e7807db331c
BLAKE2b-256 checksum
How to use checksums
282079473460a127a2ccf98f5763bf5b980c736d819c6d8af8a325540d8c8a7c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Security for pdnsbackup 1.0.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for pdnsbackup-1.0.13.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.13 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page