netcup CLI
A Python command-line interface for managing DNS records via the netcup DNS API.
Features
✅ Authentication Management: Secure credential storage using system keyring
✅ DNS Zone Info: View zone details, TTL, serial, DNSSEC status
✅ DNS Records: List, add, update, and delete DNS records
✅ Rich Output: Beautiful formatted tables and clear status messages
✅ Debug Mode: Comprehensive debugging for troubleshooting
Installation
From PyPI (Recommended)
pip install netcup-dns-cli
From Source
# Clone the repository
git clone https://github.com/danielmeint/netcup-cli.git
cd netcup-cli
# Install with uv (recommended)
uv sync
# Or install with pip
pip install -e .
Quick Start
1. Authentication
First, log in with your netcup credentials:
netcup auth login
You'll be prompted for:
- Customer Number (found in your netcup Customer Control Panel)
- API Key (generated in CCP under "API")
- API Password (generated in CCP under "API")
Credentials are securely stored in your system keyring.
2. DNS Management
View DNS zone information:
netcup dns zone info example.com
List all DNS records:
netcup dns records list example.com
Add a new DNS record:
netcup dns record add example.com subdomain A 192.168.1.1
netcup dns record add example.com mail MX mail.example.com --priority 10
Update an existing record:
netcup dns record update example.com 12345 subdomain A 192.168.1.2
Delete a record:
netcup dns record delete example.com 12345
3. Other Commands
Check authentication status:
netcup auth status
View configuration:
netcup config show
Logout:
netcup auth logout
Enable debug mode:
netcup --debug dns zone info example.com
Requirements
- Python 3.8+
- netcup account with DNS API access
- Domain(s) registered with netcup using netcup nameservers
API Access Setup
To set up API access for your netcup account, follow the official guide: Applying for an API password and API keys
Ensure DNS management is enabled for your domains in your netcup Customer Control Panel.
Troubleshooting
- Use
--debugflag for detailed API response logging - Verify your domains are using netcup nameservers
- Check that DNS management is enabled in your CCP
- Ensure API credentials have proper permissions
License
MIT License - see LICENSE file for details.
Metadata
Release files for netcup-dns-cli 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| netcup_dns_cli-0.1.2.tar.gz | 98.2 kB | Without provenance | Details for netcup_dns_cli-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| netcup_dns_cli-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for netcup_dns_cli-0.1.2-py3-none-any.whl |
Total release size: 114.3 kB
Release files / netcup_dns_cli-0.1.2.tar.gz
| Download URL | netcup_dns_cli-0.1.2.tar.gz |
|---|---|
| Size | 98.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4816030bebda9b67ce3cb879c3608dafb6a2355e43df3780b72399d6c425e9df
|
|
BLAKE2b-256 checksum How to use checksums |
e042239300ebe6390396fbbe4d87a7b6fe623dca62458299d81ad163bcecdb39
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
Release files / netcup_dns_cli-0.1.2-py3-none-any.whl
| Download URL | netcup_dns_cli-0.1.2-py3-none-any.whl |
|---|---|
| Size | 16.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
05cf2b9fff3f8ea1b29c377b831bb344a97fdfcc9f66791cf83e38c708faa8f8
|
|
BLAKE2b-256 checksum How to use checksums |
9348e4cd6c005fa06642051b741c7254c711c2244243d498fbd24e8224e88556
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
Security for netcup-dns-cli 0.1.2
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
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.