netcup-toolbox

Shell scripts, aggregated YABS results, and network reference data for netcup GmbH infrastructure (Root Server G12.5, VPS, vGPU, and Webhosting).

Companion repository for netcupgutscheine.com — open-source CLI utilities, system configs, and benchmark datasets.

Release: v0.4.0 · License: MIT · Scope: 19 active plans, 14 benchmarked plans.

Review every script before running it. The DNS updater reads credentials from environment variables and never writes them to disk or logs. Use the pinned release tag below for production automation, not main.

Netcup Gutschein & Black Week 2026 (Deutsch)

Netcup startet die Black Week am 23. November 2026; der Adventskalender läuft vom 1. bis 24. Dezember 2026. Die Aktionen wechseln täglich. Prüfe Preis, Vertragslaufzeit und Gutschein-Bedingungen immer im Netcup-Warenkorb.

Der wiederverwendbare €5-Neukunden-Code steht im Abschnitt Vouchers. Einmalige Codes werden bewusst nicht in diesem Repository veröffentlicht: Sie kommen ausschließlich über den Voucher-Dispenser.

Verify the release

tag=v0.4.0
curl -fsSLO "https://github.com/depavel/netcup-toolbox/releases/download/${tag}/netcup-toolbox-${tag}.tar.gz"
curl -fsSLO "https://github.com/depavel/netcup-toolbox/releases/download/${tag}/netcup-toolbox-${tag}.tar.gz.sha256"
sha256sum -c "netcup-toolbox-${tag}.tar.gz.sha256"
tar -xzf "netcup-toolbox-${tag}.tar.gz"
cd "netcup-toolbox-${tag}"
sha256sum -c CHECKSUMS.txt

The release archive contains every script and dataset. CHECKSUMS.txt covers every tools/*.sh script and the JSON datasets.

Documentation: Authentication · Data files · Release process.

Tools

Script	Description	Example	Web GUI
`tools/netcup-ping.sh`	ICMP latency to all 5 Netcup datacenters; supports iputils and BusyBox ping	`bash tools/netcup-ping.sh`	Live latency map
`tools/netcup-init.sh`	TCP BBR, sysctl tuning, UFW, optional Docker; dry-run and custom SSH port	`sudo bash tools/netcup-init.sh --ssh-port 22 --dry-run`	Bootstrap guide
`tools/netcup-vlan.sh`	Netplan/Debian generator for Cloud vLAN; MTU 1500 only	`bash tools/netcup-vlan.sh --interface eth1 --ip 10.0.10.1/24`	vLAN generator
`tools/netcup-dns-sync.sh`	DDNS updater for one existing A record via the CCP JSON API	`bash tools/netcup-dns-sync.sh`	DDNS guide
`tools/netcup-rdns.sh`	Get, set, or delete IPv4/IPv6 PTR records via the SCP REST API; OAuth2 device flow	`bash tools/netcup-rdns.sh get 203.0.113.10`	Mail & DNS guides
`tools/netcup-snapshot.sh`	List, create, delete, restore, or export SCP snapshots; guarded destructive actions	`bash tools/netcup-snapshot.sh servers`	Backup guide
`tools/netcup-mail-check.sh`	MX, SPF, DMARC, DKIM, PTR, and outbound port 25 checks	`bash tools/netcup-mail-check.sh example.com`	Mail guide
`tools/netcup-exporter.sh`	Prometheus textfile metrics for uptime, load, memory, disk, BBR, CPU steal, and latency	`bash tools/netcup-exporter.sh --textfile /var/lib/node_exporter/textfile/netcup.prom`	Tools hub
`tools/netcup-calc.sh`	VAT and billing calculator for all active plans; ceiling rounding	`bash tools/netcup-calc.sh`	VAT calculator

Latency check (`netcup-ping.sh`)

Runs 3 ICMP probes per datacenter by default and prints min/avg/max latency and packet loss. Use --json or --csv for automation, and --count / --timeout to tune the probe. The parser handles both common Linux output formats:

iputils: rtt min/avg/max/mdev = ...
BusyBox: round-trip min/avg/max = ...

curl -fsSL https://github.com/depavel/netcup-toolbox/raw/v0.4.0/tools/netcup-ping.sh -o /tmp/netcup-ping.sh
less /tmp/netcup-ping.sh
bash /tmp/netcup-ping.sh

Run the parser self-test without sending packets:

bash /tmp/netcup-ping.sh --self-test
bash /tmp/netcup-ping.sh --json --count 5

Example output:

Netcup Datacenter Latency Probe (ICMP 3-packet average)
--------------------------------------------------------------------
Location           Test IP          Min        Avg        Max        Loss    
--------------------------------------------------------------------
Nuremberg (DE)     188.68.56.104    30.2ms     31.6ms     32.6ms     0%      
Vienna (AT)        89.58.16.1       38.8ms     39.0ms     39.3ms     0%      
Amsterdam (NL)     152.53.104.2     34.7ms     36.1ms     37.8ms     0%      
Manassas (US)      152.53.68.2      118.4ms    120.0ms    121.6ms    0%      
Singapore (SG)     217.146.9.10     189.1ms    192.0ms    195.0ms    0%      
--------------------------------------------------------------------

Server bootstrap (`netcup-init.sh`)

Applies performance and security defaults on a fresh Debian 12 / Ubuntu 24.04 instance:

sets TCP congestion control to BBR and a small sysctl profile;
installs baseline packages and unattended-upgrades;
writes UFW rules for the selected SSH port plus 80/443;
verifies that SSH is listening before enabling UFW;
installs Docker only with --with-docker.

curl -fsSL https://github.com/depavel/netcup-toolbox/raw/v0.4.0/tools/netcup-init.sh -o /tmp/netcup-init.sh
less /tmp/netcup-init.sh
sudo bash /tmp/netcup-init.sh --ssh-port 22 --dry-run
sudo bash /tmp/netcup-init.sh --ssh-port 22 --yes

Docker + UFW: Docker publishes container ports through its own iptables rules and can bypass UFW. Review DOCKER-USER rules before exposing containers. A full apt-get upgrade is opt-in via --full-upgrade.

Cloud vLAN configuration (`netcup-vlan.sh`)

Generates Netplan or Debian network configuration for a private vLAN inside one Netcup datacenter. Netcup Cloud vLAN uses MTU 1500; jumbo frames are not supported. The script rejects --mtu 9000 instead of generating a config that can silently drop large packets.

bash tools/netcup-vlan.sh --interface eth1 --ip 10.0.10.1/24
sudo bash tools/netcup-vlan.sh --interface eth1 --ip 10.0.10.1/24 --apply

Interactive web version: https://netcupgutscheine.com/en/tools#vlan.

Dynamic DNS (`netcup-dns-sync.sh`)

Updates exactly one existing A record through the official CCP JSON API. It checks login and infoDnsRecords status, validates the detected public IPv4 address, and refuses to guess when the host has zero or multiple A records.

export NETCUP_CUSTOMER_NUMBER="123456"
export NETCUP_API_KEY="your-api-key"
export NETCUP_API_PASSWORD="your-api-password"
export NETCUP_DOMAIN_NAME="example.com"
export NETCUP_HOST_NAME="vpn"

bash tools/netcup-dns-sync.sh

Credentials are read from the environment and are never written to disk or printed. Run it from cron with a dedicated user and a lock file (the script uses flock when available).

Reverse DNS (`netcup-rdns.sh`)

Manages PTR records for IPv4 and IPv6 through the SCP REST API. A correct PTR is required for reliable mail delivery; Netcup manages rDNS separately from the CCP DNS zone.

bash tools/netcup-rdns.sh auth login
bash tools/netcup-rdns.sh get 203.0.113.10
bash tools/netcup-rdns.sh set 203.0.113.10 mail.example.com
bash tools/netcup-rdns.sh delete 203.0.113.10 --yes

The script uses the OAuth2 device flow (no password or static API key) and stores only a refresh token with mode 600. See docs/AUTH.md.

Snapshots (`netcup-snapshot.sh`)

Lists, creates, deletes, restores, and exports SCP snapshots through the SCP REST API. restore reverts the disks and reboots the server; delete and restore require --yes.

bash tools/netcup-snapshot.sh auth login
bash tools/netcup-snapshot.sh servers
bash tools/netcup-snapshot.sh list 123456
bash tools/netcup-snapshot.sh create 123456 pre-upgrade --description "before upgrade" --wait
bash tools/netcup-snapshot.sh restore 123456 pre-upgrade --yes --wait

Offline snapshots may require --disk <name>; use servers or list to inspect the server and its snapshots. Export requires the server to be shut off.

Mail DNS and port 25 (`netcup-mail-check.sh`)

Checks MX, SPF, DMARC, DKIM presence, A/AAAA, PTR, and outbound TCP/25 reachability. It is a presence and reachability check, not a full policy evaluator.

bash tools/netcup-mail-check.sh example.com
bash tools/netcup-mail-check.sh example.com --selector mail --json
bash tools/netcup-mail-check.sh example.com --no-port-check

Requires dig. A port 25 check from a residential ISP may report the ISP block rather than the destination. Run it from a server with outbound port 25 for a meaningful result.

Prometheus exporter (`netcup-exporter.sh`)

Writes a Prometheus textfile with local host metrics and one-packet ICMP latency to all 5 Netcup test IPs. It is designed for node_exporter --collector.textfile.directory, cron, or a systemd timer.

bash tools/netcup-exporter.sh --textfile /var/lib/node_exporter/textfile/netcup.prom
bash tools/netcup-exporter.sh --no-latency

Missing measurements are omitted or reported with a *_probe_success 0 gauge; they are never converted to a fake zero. No Netcup credentials are required.

Terminal pricing and VAT (`netcup-calc.sh`)

Calculates net and gross prices for all 19 active plans. Netcup rounds gross prices up to the next cent when VAT is greater than 0%; the 0% regions keep the exact net price. This was verified against the official netcup.com RS 500 G12.5 card on 2026-10-31: EUR 10.86 net × 1.19 = EUR 12.9234 → EUR 12.93.

bash tools/netcup-calc.sh
bash tools/netcup-calc.sh --plan RS --json
bash tools/netcup-calc.sh --self-test

Hardware benchmarks

Aggregated YABS results for 14 active plans, generated from our official Netcup test account. Methodology: Debian 12 minimal, Geekbench 6.3, FIO 3.33 4K mixed NVMe, and CPU steal from vmstat. The JSON file is a convenience extract of data/servers.json; it is not a raw YABS log archive. Webhosting is managed shared hosting and is not benchmarked.

Plan	Architecture	Geekbench 6 Single	Geekbench 6 Multi	FIO 4K NVMe IOPS	CPU Steal
RS 500 G12.5	2 Dedicated Cores (AMD EPYC 9645)	2285	4210	182.5k IOPS (730 MB/s)	0.0%
RS 1000 G12.5	4 Dedicated Cores (AMD EPYC 9645)	2290	7559	187.3k IOPS (749 MB/s)	0.0%
RS 2000 G12.5	8 Dedicated Cores (AMD EPYC 9645)	2295	13420	192.0k IOPS (768 MB/s)	0.0%
RS 4000 G12.5	12 Dedicated Cores (AMD EPYC 9645)	2301	17890	198.5k IOPS (794 MB/s)	0.0%
RS 8000 G12.5	16 Dedicated Cores (AMD EPYC 9645)	2305	21940	204.0k IOPS (816 MB/s)	0.0%
RS 2000 vGPU 7	8 Dedicated Cores (AMD EPYC 9535) + NVIDIA H200 (7 GB VRAM)	2210	12400	195.0k IOPS (780 MB/s)	0.0%
RS 4000 vGPU 14	12 Dedicated Cores (AMD EPYC 9535) + NVIDIA H200 (14 GB VRAM)	2225	17200	202.0k IOPS (808 MB/s)	0.0%
VPS pico G11.5s	1 vCore (Low-Cost Node)	980	1450	45.0k IOPS (180 MB/s)	1.8%
VPS 500 G12.5	2 vCores (x86)	1710	2890	115.0k IOPS (460 MB/s)	1.4%
VPS 1000 G12.5	4 vCores (x86)	1720	4650	130.0k IOPS (520 MB/s)	1.2%
VPS 1000 ARM G12.5	4 ARM64 vCores	1020	4980	142.0k IOPS (568 MB/s)	0.4%
VPS 2000 G12.5	8 vCores (x86)	1740	7980	138.0k IOPS (552 MB/s)	1.1%
VPS 4000 G12.5	12 vCores (x86)	1755	11200	145.0k IOPS (580 MB/s)	1.0%
VPS 8000 G12.5	16 vCores (x86)	1760	14100	150.0k IOPS (600 MB/s)	0.9%

Notes:

Root Server instances use dedicated AMD EPYC 9645 threads with 0.0% CPU steal.
vGPU instances use fractional NVIDIA H200 allocations (7 GB and 14 GB VRAM) for local inference.
VPS instances use shared vCPUs on AMD EPYC host nodes.

Server specifications and multi-region pricing

The table covers all 19 active plans. Non-EU and EU business customers (B2B reverse charge) pay the net price; German consumers pay 19% VAT, Austrian consumers 20%, and Polish consumers 23%. Archived G11/G12 plans are documented on the site but are excluded from this active-plan dataset.

Plan	Status	RAM	Storage	Port	0% VAT (Non-EU / EU B2B)	19% DE	20% AT	23% PL	Details
RS 500 G12.5	Available	4 GB	64 GB NVMe	2.5 Gbit/s	€10.86	€12.93	€13.04	€13.36	Specs & plan page
RS 1000 G12.5	Available	8 GB	128 GB NVMe	2.5 Gbit/s	€18.26	€21.73	€21.92	€22.46	Specs & plan page
RS 2000 G12.5	Available	16 GB	256 GB NVMe	2.5 Gbit/s	€34.20	€40.70	€41.04	€42.07	Specs & plan page
RS 4000 G12.5	Available	32 GB	512 GB NVMe	2.5 Gbit/s	€65.40	€77.83	€78.48	€80.45	Specs & plan page
RS 8000 G12.5	Available	64 GB	1 TB NVMe	2.5 Gbit/s	€124.72	€148.42	€149.67	€153.41	Specs & plan page
RS 2000 vGPU 7	Sold out	16 GB	512 GB NVMe	2.5 Gbit/s	€102.33	€121.77	€122.80	€125.87	Specs & plan page
RS 4000 vGPU 14	Sold out	32 GB	1 TB NVMe	2.5 Gbit/s	€195.32	€232.43	€234.39	€240.25	Specs & plan page
VPS nano G11.5s	Available	2 GB	60 GB SSD	1 Gbit/s	€3.10	€3.69	€3.73	€3.82	Specs & plan page
VPS pico G11.5s	Available	1 GB	30 GB SSD	1 Gbit/s	€1.86	€2.21	€2.23	€2.29	Specs & plan page
VPS 500 G12.5	Available	4 GB	64 GB SSD	2.5 Gbit/s	€6.94	€8.26	€8.33	€8.54	Specs & plan page
VPS 1000 G12.5	Available	8 GB	128 GB SSD	2.5 Gbit/s	€12.18	€14.50	€14.62	€14.99	Specs & plan page
VPS 1000 ARM G12.5	Available	8 GB	128 GB NVMe	2.5 Gbit/s	€12.18	€14.50	€14.63	€14.99	Specs & plan page
VPS 2000 G12.5	Available	16 GB	256 GB SSD	2.5 Gbit/s	€22.62	€26.92	€27.15	€27.83	Specs & plan page
VPS 4000 G12.5	Available	32 GB	512 GB SSD	2.5 Gbit/s	€38.11	€45.36	€45.74	€46.88	Specs & plan page
VPS 8000 G12.5	Available	64 GB	1 TB SSD	2.5 Gbit/s	€56.39	€67.11	€67.67	€69.36	Specs & plan page
Webhosting 2000	Available	4 GB	150 GB SSD (3 Free Domains)	1 Gbit/s	€3.39	€4.03	€4.07	€4.17	Specs & plan page
Webhosting 4000	Available	4 GB	500 GB SSD (6 Free Domains)	1 Gbit/s	€6.81	€8.10	€8.17	€8.38	Specs & plan page
Webhosting 8000	Available	8 GB	1000 GB SSD (12 Free Domains)	1 Gbit/s	€11.07	€13.17	€13.29	€13.62	Specs & plan page
Webhosting 2000 30Prozent Rabatt NUE 1M	Available	4 GB	150 GB SSD (75 GB Web + 75 GB Mail, 3 Free Domains)	1 Gbit/s	€2.37	€2.82	€2.85	€2.92	Specs & plan page

Sold out: RS 2000 vGPU 7, RS 4000 vGPU 14. Specs and benchmark data remain listed for reference, but no voucher claim is offered while availability is sold-out. Availability was last checked on 2026-11-03.

Vouchers

The reusable new-customer code 36nc17927037630 gives a €5 discount on a new Netcup order (except domains) and does not expire after a single use.

Single-use codes are intentionally not published in this repository. They are issued by the site’s voucher dispenser, and publishing them would let the first reader burn a code before an actual visitor can claim it. The site is the authoritative source for current availability:

Featured plan	Catalog offer	Plan page
RS 1000 G12.5	2 Months Free	Open plan page
RS 2000 G12.5	1 Month Free	Open plan page
RS 8000 G12.5	1 Month Free	Open plan page
VPS 1000 G12.5	1 Month Free	Open plan page
VPS 2000 G12.5	1 Month Free	Open plan page
VPS 4000 G12.5	1 Month Free	Open plan page
Webhosting 2000	30% Monthly Discount	Open plan page
Webhosting 4000	30% Monthly Discount	Open plan page

Offer labels are copied from the site catalog for orientation only. The Netcup checkout is authoritative for price, VAT, and voucher eligibility.

Official Netcup test IPs

Official Netcup IPv4 addresses used for routing and latency measurement:

Location	Region	IPv4	Looking Glass
Nuremberg (DE)	europe	`188.68.56.104`	lookingglass.netcup.net
Vienna (AT)	europe	`89.58.16.1`	lookingglass.netcup.net
Amsterdam (NL)	europe	`152.53.104.2`	lookingglass.netcup.net
Manassas, VA (US)	north-america	`152.53.68.2`	lookingglass.netcup.net
Singapore (SG)	asia-pacific	`217.146.9.10`	lookingglass.netcup.net

Data files

data/servers.json — canonical active-plan catalog (19 plans) generated from the site catalog, including availability and availabilityCheckedAt.
data/benchmarks.json — aggregated benchmark extract (14 plans), derived from data/servers.json. It is not a raw log archive.
data/datacenters.json — official test IPs, regions, and verified dates for all 5 Netcup datacenters.
data/meta.json — schema version, generation timestamp, availability date, and dataset counts.

Interactive tools

Contributing

See CONTRIBUTING.md. Run shellcheck and the built-in self-tests before opening a pull request.

Security

See SECURITY.md. Do not open public issues for vulnerabilities or paste API credentials into an issue.

License

MIT License. See LICENSE.

Independent community resource. Not operated by netcup GmbH.

Name		Name	Last commit message	Last commit date
.github		.github
data		data
docs		docs
tools		tools
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CHECKSUMS.txt		CHECKSUMS.txt
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
ROADMAP.md		ROADMAP.md
SECURITY.md		SECURITY.md
SUPPORT.md		SUPPORT.md
VERSION		VERSION

Navigation Menu

Repository navigation

About

Repository files navigation

netcup-toolbox

Netcup Gutschein & Black Week 2026 (Deutsch)

Verify the release

Tools

Latency check (`netcup-ping.sh`)

Server bootstrap (`netcup-init.sh`)

Cloud vLAN configuration (`netcup-vlan.sh`)

Dynamic DNS (`netcup-dns-sync.sh`)

Reverse DNS (`netcup-rdns.sh`)

Snapshots (`netcup-snapshot.sh`)

Mail DNS and port 25 (`netcup-mail-check.sh`)

Prometheus exporter (`netcup-exporter.sh`)

Terminal pricing and VAT (`netcup-calc.sh`)

Hardware benchmarks

Server specifications and multi-region pricing

Vouchers

Official Netcup test IPs

Data files

Interactive tools

Contributing

Security

License

About

Releases

Packages

Used by

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

netcup-toolbox

Netcup Gutschein & Black Week 2026 (Deutsch)

Verify the release

Tools

Latency check (netcup-ping.sh)

Server bootstrap (netcup-init.sh)

Cloud vLAN configuration (netcup-vlan.sh)

Dynamic DNS (netcup-dns-sync.sh)

Reverse DNS (netcup-rdns.sh)

Snapshots (netcup-snapshot.sh)

Mail DNS and port 25 (netcup-mail-check.sh)

Prometheus exporter (netcup-exporter.sh)

Terminal pricing and VAT (netcup-calc.sh)

Hardware benchmarks

Server specifications and multi-region pricing

Vouchers

Official Netcup test IPs

Data files

Interactive tools

Contributing

Security

License

About

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages

Latency check (`netcup-ping.sh`)

Server bootstrap (`netcup-init.sh`)

Cloud vLAN configuration (`netcup-vlan.sh`)

Dynamic DNS (`netcup-dns-sync.sh`)

Reverse DNS (`netcup-rdns.sh`)

Snapshots (`netcup-snapshot.sh`)

Mail DNS and port 25 (`netcup-mail-check.sh`)

Prometheus exporter (`netcup-exporter.sh`)

Terminal pricing and VAT (`netcup-calc.sh`)