Skip to main content

Manage domains hosted on through the KAS server API

Project description

Build Status Coverage Status PyPI Version

kasserver - Manage domains hosted on through the KAS server API

This project consists of the Python library kasserver and a few command line utilities to manage domains of the German webhoster through their KAS server API.

At the moment the main focus is managing DNS record as this allows to automate the creation of Let's Encrypt (wildcard) certificates with the ACME DNS-01 challenge.


kasserver (and its dependencies) can be installed from PyPI with: pip3 install kasserver


Both library and command line utilities require access to the KAS credentials. Username and password are read from the KASSERVER_USER and KASSERVER_PASSWORD environment variables or from the ~/.netrc file:

password PASSWORD

The file must be accessible only by your user account: chmod 600 ~/.netrc.



A generic program to manage DNS records.

DNS records can be listed with:

$ kasserver-dns list
ID C Zone        Name Type  Data               Aux
 1 Y      A     X.X.X.X            0
 0 N      NS 0
 0 N      NS 0
 0 N www  CNAME        0

A new DNS record is added with:

kasserver-dns add CNAME

An existing DNS record is removed with:

kasserver-dns remove CNAME


The following programs are designed to be used together with ACME clients to automate DNS record creation/removal as it is required by a Let's Encryt ACME DNS-01 challenge for automatic certificate renewal.


This program is designed to be used with Certbot:

certbot certonly -d --preferred-challenges dns \
                 --manual --manual-auth-hook kasserver-dns-certbot \
                          --manual-cleanup-hook kasserver-dns-certbot \


This program is designed to be used with lego:

EXEC_PATH=kasserver-dns-lego lego --dns exec \
    --domains --email run


This projected is licensed under the terms of the MIT license.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kasserver-0.4.0.tar.gz (12.5 kB view hashes)

Uploaded source

Built Distribution

kasserver-0.4.0-py3-none-any.whl (11.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page