Entwickler

Hostwolf Apps für Entwickler

Mit Hostwolf Apps entwickeln

Alles, was du in der Konsole machst, geht auch per Code: Apps aus git, einem Dockerfile oder einem Image erstellen, sie deployen, ihre Logs lesen, Variablen setzen, verwaltete Datenbanken hinzufügen und Autoscaling einschalten.

API-Token holen#

  1. Melde dich in der Konsole an und öffne Schlüssel & Tokens → API-Tokens.
  2. Gib eine Beschreibung ein, wähle, wie lange das Token gilt, und hake seine Berechtigungen an.
  3. Klicke auf Token erstellen und kopiere es. Es sieht aus wie 12|aBcD… und wird nur einmal angezeigt.
The API tokens page in the Hostwolf Apps console, with the Write, Deploy and Read permissions ticked
Schlüssel & Tokens → API-Tokens in der Konsole.
BerechtigungWas es erlaubt
LesenProjekte, Apps, Deployments, Server, Datenbanken und Einstellungen auflisten und lesen. Geheime Werte bleiben verborgen.
Sensible Daten lesenAußerdem App-Logs, Variablenwerte und Verbindungs-URLs von Datenbanken lesen.
SchreibenProjekte, Apps, Variablen, Volumes und Datenbanken anlegen, ändern und löschen.
DeployApps deployen, starten, stoppen und neu starten, auch über Deploy-Webhooks.
RootAlles oben Genannte. Vermeide es für Skripte und Assistenten.
  • Ein Token gehört zu dem Team, in dem du warst, als du es erstellt hast, und sieht nur die Ressourcen dieses Teams.
  • Team-Mitglieder (keine Admins oder Owner) können nur Tokens mit Lesen erstellen.
  • Für ein Skript, das deployt, hake Lesen, Schreiben und Deploy an. Füge Sensible Daten lesen nur hinzu, wenn es Logs oder Secrets braucht.
  • Tokens können keine Server kaufen oder kündigen. Die Abrechnung bleibt in der Konsole, und die Tarife stehen unter Preise.
  • Nutze ein Token pro Skript oder Assistent, damit du eins widerrufen kannst, ohne die anderen kaputtzumachen.

Schnellstart#

Sende das Token als Authorization: Bearer <token> an https://console.app.hostwolf.net/api/v1:

curl

# Your apps
curl https://console.app.hostwolf.net/api/v1/applications \
  -H "Authorization: Bearer $HOSTWOLF_APPS_TOKEN" \
  -H "Accept: application/json"

# Deploy one
curl -X POST https://console.app.hostwolf.net/api/v1/applications//start \
  -H "Authorization: Bearer $HOSTWOLF_APPS_TOKEN"

TypeScript

npm install https://app.hostwolf.net/dl/hostwolf-apps-sdk-0.2.1.tgz
import { HostwolfApps } from '@hostwolf/apps-sdk';

const hw = new HostwolfApps({ token: process.env.HOSTWOLF_APPS_TOKEN! });
const [app] = await hw.applications.list();
const deployment = await hw.deployAndWait(app.uuid);
console.log(deployment.status, await hw.applications.logs(app.uuid, { lines: 20 }));

KI-Assistent (MCP)

claude mcp add --transport http hostwolf-apps https://app.hostwolf.net/mcp --header "Authorization: Bearer your_token"

Dann frag: „Warum ist das letzte Deployment meines Shops fehlgeschlagen? Korrigier den Startbefehl und deploye ihn neu.“ Das ist der gehostete Server unter https://app.hostwolf.net/mcp, ohne etwas zu installieren. Unter MCP-Einrichtung findest du Claude Desktop, Cursor und VS Code, oder wie du ihn selbst betreibst.

Der Schnellstart Schritt für Schritt deployt eine App von GitHub mit nichts als curl.

Was du bauen kannst#

Deployments aus CIDeploye nach bestandenen Tests mit einem API-Aufruf und warte auf das Ergebnis.
Vorschau-UmgebungenLege pro Branch eine Projekt-Umgebung an und räume sie ab, wenn der Branch gemergt ist.
Secrets-SyncÜbertrage Variablen aus deinem Secret-Speicher mit Massen-Updates.
Datenbanken auf AbrufErstelle eine verwaltete Datenbank und verbinde sie mit zwei Aufrufen mit einer App.
Traffic-SpitzenSchalte vor einem Launch Autoscaling mit einer monatlichen Obergrenze ein.
KI-gestützter BetriebLass einen Assistenten Build-Logs lesen, Einstellungen korrigieren und für dich neu deployen.

Downloads#

Das SDK und der MCP-Server kommen von app.hostwolf.net, nicht aus der npm-Registry. Du musst dich nirgends anmelden, und jede Version hat eine feste URL:

PaketInstallation
TypeScript-SDKnpm install https://app.hostwolf.net/dl/hostwolf-apps-sdk-0.2.1.tgz
MCP-Servernpx -y https://app.hostwolf.net/dl/hostwolf-apps-mcp-0.2.1.tgz

/dl/index.json listet die aktuellen Versionen mit SHA-256- und npm-Integritäts-Hashes. Die OpenAPI-3.1-Beschreibung der API liegt unter /developers/openapi.json, für Codegeneratoren und API-Clients.

Kommst du nicht weiter, oder fehlt ein Endpunkt? Sag es uns unter app.hostwolf.net/contact oder [email protected].