Proxy Platform CLI

Beheer uw organisaties, clusters, Nextcloud-omgevingen, marketplace-apps, GPU-aanvragen, bestellingen, abonnementen, firewalls en support tickets vanaf de commandline met de officiële Proxy Platform CLI.

Tip

De CLI is bedoeld voor automatisering, scripting en CI/CD-pipelines. Voor eenmalige acties is het Control Panel meestal sneller.

Installatie

Python 3.11 of nieuwer

Terminal


python3 --version

Heeft u nog geen Python 3.11+? Installeer dit via python.org of uw pakketbeheerder (brew install python@3.11 op macOS).

pipx (aanbevolen)

pipx installeert de CLI in een geïsoleerde omgeving zonder uw systeem-Python te vervuilen.

macOS

Terminal


brew install pipx
pipx ensurepath

Linux

Terminal


sudo apt install pipx       # Debian/Ubuntu
# of
sudo dnf install pipx       # Fedora/RHEL
 
pipx ensurepath

Windows (WSL)

Terminal


sudo apt install pipx
pipx ensurepath

CLI installeren

Terminal


pipx install proxy-platform

Verifiëren

Terminal


proxy-platform --help
proxy-platform version

Organisaties, de winkelwagen, marketplace-apps, GPU-aanvragen, het schalen van clusters en de uitgebreide Nextcloud-commando’s vereisen versie 0.9.1 of hoger. Heeft u een oudere versie, werk de CLI dan bij met pipx upgrade proxy-platform.

Eerste gebruik

Inloggen

Terminal


proxy-platform login

U wordt gevraagd om uw e-mailadres en wachtwoord. Heeft u 2FA aan staan, dan vraagt de CLI ook om de OTP-code.

Tokens worden veilig opgeslagen in ~/.proxy-platform/tokens.json met permissies 0600 en automatisch ververst zodra ze verlopen.

Profiel bekijken

Terminal


proxy-platform whoami

Productcatalogus bekijken

Terminal


proxy-platform products list

Werken binnen een organisatie

Bent u lid van een of meer organisaties? Kies dan in welke context de CLI werkt. Clusters, Nextcloud-omgevingen, databases en firewalls worden in die context getoond en aangemaakt, net als in het Control Panel.

Terminal


# Uw organisaties en uw rol in elke organisatie
proxy-platform organizations list
 
# Werken binnen een organisatie
proxy-platform organizations use <organisatie-id>
 
# Terug naar uw persoonlijke account
proxy-platform organizations use personal
 
# Huidige context tonen
proxy-platform organizations current

De CLI onthoudt uw keuze. In scripts kunt u de context per commando overschrijven met de omgevingsvariabele PROXY_PLATFORM_CONTEXT (een organisatie-ID of personal).

Eigenaren en beheerders kunnen de organisatie ook vanaf de commandline beheren:

Terminal


# Leden en hun rollen
proxy-platform organizations members list
proxy-platform organizations members role <gebruiker-id> --role finance
 
# Iemand uitnodigen
proxy-platform organizations invites create --email collega@bedrijf.nl --role readonly
 
# Openstaande uitnodigingen voor uzelf accepteren
proxy-platform organizations invites pending
proxy-platform organizations invites accept <uitnodiging-id>
 
# Een resource beschermen tegen verwijderen
proxy-platform organizations locks add --type cluster --resource-id <cluster-id> --reason "Productie"

Veelgebruikte commando’s

Clusters

Terminal


# Eigen clusters tonen
proxy-platform clusters list
 
# Details van één cluster
proxy-platform clusters get <cluster-id>
 
# Kubeconfig downloaden
proxy-platform clusters kubeconfig <cluster-id> --output ~/.kube/config
 
# Naam wijzigen
proxy-platform clusters rename <cluster-id> --name "Productie cluster"
 
# Cluster verwijderen (toont preview en vraagt bevestiging)
proxy-platform clusters delete <cluster-id>

Clusters schalen

Terminal


# Mogelijkheden en beschikbare servertypes bekijken
proxy-platform clusters scale-options <cluster-id>
 
# Eerst de prijs bekijken, dan schalen
proxy-platform clusters scale-quote <cluster-id> --nodes 5
proxy-platform clusters scale <cluster-id> --nodes 5
 
# Afschalen per einde maand; tot dan terug te draaien
proxy-platform clusters scale <cluster-id> --nodes 3 --end-of-month
proxy-platform clusters cancel-downscale <cluster-id>
 
# Control plane uitbreiden voor hoge beschikbaarheid
proxy-platform clusters cp-scale <cluster-id> --count 3
 
# Provisioning- en operationele logs
proxy-platform clusters logs <cluster-id>

Bij opschalen betaalt u direct het pro-rata bedrag voor de rest van de maand. Bij afschalen volgt geen restitutie over de lopende maand.

Marketplace-apps op uw cluster

Terminal


# Geïnstalleerde apps tonen
proxy-platform apps list <cluster-id>
 
# Een app uit de marketplace installeren
proxy-platform marketplace list
proxy-platform apps install <cluster-id> --listing <listing-id> --name grafana --namespace monitoring
 
# Status, endpoints en recente logs
proxy-platform apps get <cluster-id> <deployment-id>
 
# Upgraden: eerst het plan bekijken
proxy-platform apps upgrade-plan <cluster-id> <deployment-id> --version <versie-id>
proxy-platform apps upgrade <cluster-id> <deployment-id> --version <versie-id>
 
# Verwijderen
proxy-platform apps uninstall <cluster-id> <deployment-id>

Managed Nextcloud

Terminal


# Uw omgevingen
proxy-platform nextcloud list
proxy-platform nextcloud get <omgeving-id>
 
# Meer gebruikers of opslag, of extra modules (talk, groupware, office)
proxy-platform nextcloud upgrade-quote <omgeving-id> --users 25 --storage-per-user 20
proxy-platform nextcloud upgrade <omgeving-id> --add-modules talk
 
# Inloggegevens van de beheerder; bevestig daarna dat u ze heeft opgeslagen
proxy-platform nextcloud credentials <omgeving-id>
proxy-platform nextcloud credentials-ack <omgeving-id>
 
# Eigen domein instellen
proxy-platform nextcloud set-domain <omgeving-id> cloud.bedrijf.nl
proxy-platform nextcloud verify-domain <omgeving-id>

Maak voor een eigen domein eerst bij uw DNS-provider een CNAME-record aan dat naar het standaarddomein van uw omgeving wijst. Dat domein ziet u in de URL bij proxy-platform nextcloud get <omgeving-id>. Controleer daarna met verify-domain of het record goed staat.

Het beheerderswachtwoord is om veiligheidsredenen maar beperkt opvraagbaar. Is het niet meer beschikbaar, vraag dan een nieuw aan met proxy-platform nextcloud reset-admin-password <omgeving-id>.

GPU-clusters aanvragen

GPU-clusters bestelt u niet direct: u dient een aanvraag in, wij beoordelen die en geven een prijs vrij, en daarna bestelt u het cluster tegen die prijs.

Terminal


proxy-platform gpu-requests create \
  --group role=control_plane,count=3,cpu=4,ram_gb=8 \
  --group role=worker,count=2,server_type=<gpu-servertype> \
  --months 6 \
  --note "Voor ons AI-team"
 
# Status en vrijgegeven prijs volgen
proxy-platform gpu-requests list
proxy-platform gpu-requests get <aanvraag-id>
 
# Na vrijgave: in de winkelwagen zetten en bestellen
proxy-platform gpu-requests order <aanvraag-id> --name ai-cluster
proxy-platform cart checkout --accept-documents

Bestellen

Bestellen gaat, net als in het Control Panel, via de winkelwagen. U kunt er eerst een offerte van maken.

Terminal


# Product toevoegen aan de winkelwagen
proxy-platform cart add --product <product-id> --tier <tier-id> --type cluster --name productie \
  --config '{"provider": "hetzner", "region": "fsn1"}'
proxy-platform cart show
 
# Kortingscode controleren
proxy-platform cart coupon-check WELKOM25
 
# Optioneel: offerte maken en als PDF opslaan
proxy-platform cart quote --reference PO-2026-114 --output offerte.pdf
 
# Bestellen; u accepteert de voorwaarden expliciet
proxy-platform documents list
proxy-platform cart checkout --accept-documents

Bij online betalen krijgt u een betaallink. Betalen op inkooporder (--payment-method purchase_order) is alleen mogelijk als Proxy dat voor uw organisatie heeft ingeschakeld; neem daarvoor contact met ons op.

U kunt ook één product direct bestellen:

Terminal


# Interactief: leidt u door product → tier → provider → regio → firewall
proxy-platform orders create
 
# Volledig niet-interactief (handig voor automatisering)
proxy-platform orders create \
  --tier "Starter Kit" \
  --provider hetzner \
  --region nbg1 \
  --firewall "Productie firewall" \
  --yes
 
# Bestellingen overzicht
proxy-platform orders list
proxy-platform orders get <order-id>

Firewalls

Terminal


# Overzicht en details
proxy-platform firewall list
proxy-platform firewall get <firewall-id>
 
# Firewall aan cluster koppelen
proxy-platform clusters assign-firewall <cluster-id> --firewall "Productie firewall"

Abonnementen

Terminal


proxy-platform subscriptions list
 
# Opzeggen per einde van de maand; de dienst blijft tot dan beschikbaar
proxy-platform subscriptions cancel <abonnement-id>
 
# Een opzegging terugdraaien, zolang de einddatum nog niet bereikt is
proxy-platform subscriptions resume <abonnement-id>

Support en feedback

Terminal


# Support ticket aanmaken
proxy-platform support submit \
  --subject "Vraag over factuur" \
  --description "Ik mis een specificatie op factuur 2026-001" \
  --category billing
 
# Feedback indienen
proxy-platform feedback submit \
  --title "Donker thema" \
  --description "Graag een donker thema in het Control Panel" \
  --category feature_request

Tab-completion inschakelen

Terminal


proxy-platform --install-completion

Herstart uw shell of source ~/.zshrc / source ~/.bashrc.

Verbose modus

Loopt u tegen iets aan? Voeg --verbose toe om alle API-calls en responses te zien:

Terminal


proxy-platform --verbose clusters list

Updaten

Terminal


pipx upgrade proxy-platform

Verwijderen

Terminal


pipx uninstall proxy-platform
rm -rf ~/.proxy-platform

Vereisten

Python 3.11 of nieuwer
Internetverbinding naar de Proxy Platform API
Een Proxy Platform account (account aanmaken)

Bekend probleem oplossen

Note

proxy-platform: command not found

pipx ensurepath heeft uw shell-PATH bijgewerkt maar u moet de shell opnieuw openen. Sluit en heropen uw terminal, of run exec $SHELL.

Note

Not authenticated

Uw token is verlopen of niet aanwezig. Run proxy-platform login opnieuw.

Bron en feedback

De CLI is open voor feedback via proxy-platform feedback submit of via een support ticket.