Skip to content
BTC MAIN · Managed AI Now

Schnellstart

Dieser Guide begleitet euch von der ersten Anmeldung bis zur laufenden Anwendung. Ihr benötigt dafür etwa 15–20 Minuten.

Voraussetzungen

  • Zugang zur Plattform (API-Token und Zugangsdaten vom IT-Servicedesk)
  • Git installiert (lokal)
  • Docker installiert (lokal, zum Testen des Builds)
  • Eine Anwendung mit Dockerfile oder einem unterstützten Runtime-Profil

Schritt-für-Schritt

  1. Anmelden

    Öffnet die Plattform-Oberfläche und meldet euch mit euren Zugangsdaten an.

    Nach dem Login seht ihr das Dashboard mit einer Übersicht aller euch zugänglichen Projekte.

  2. Projekt wählen oder anlegen

    Wählt ein bestehendes Projekt aus oder legt ein neues an:

    • Klick auf “Neues Projekt”
    • Name und optionale Beschreibung eingeben
    • Bestätigen

    Projekte sind logische Gruppen für zusammengehörige Anwendungen (z. B. backend, frontend, worker).

  3. Neue Anwendung anlegen

    Innerhalb des Projekts: “Neue Ressource” → “Anwendung” → “Öffentliches/Privates Repository”

    Füllt die Felder aus:

    FeldBeispiel
    Repository-URLhttps://git.coolai.btc-ag.cloud/meinteam/meine-app
    Branchmain
    Build-PackDockerfile
    Port3000 (oder euer App-Port)

  4. Domain konfigurieren

    Unter “Domains” tragt ihr die gewünschte Adresse ein, z. B.:

    meine-app.btc-ag.cloud

    Das TLS-Zertifikat wird automatisch ausgestellt — kein manueller Schritt nötig.

  5. Umgebungsvariablen setzen

    Unter “Umgebungsvariablen” könnt ihr alle nötigen Konfigurationswerte hinterlegen.

    DATABASE_URL=postgresql://...
    APP_ENV=production
    LOG_LEVEL=info

  6. Erstes Deployment auslösen

    Klick auf “Deployen” — die Plattform:

    • Klont das Repository
    • Baut das Docker-Image
    • Startet den Container
    • Aktiviert das Routing über den Reverse Proxy

    Ihr könnt den Build-Log in Echtzeit verfolgen.

  7. Anwendung prüfen

    Nach erfolgreichem Deployment ist die App unter der konfigurierten Domain erreichbar.

    Im Dashboard seht ihr:

    • Deployment-Status (grün = läuft)
    • Letzten Deployment-Zeitstempel
    • Link zur laufenden Instanz

Nächste Schritte

Jetzt, wo eure erste App läuft, richtet ihr am besten den automatischen Deployment-Trigger ein: