Apps

cipi app create

cipi app create unterstützt zwei App-Typen: Laravel (Standard) und Benutzerdefiniert (--custom). Laravel Apps erhalten eine vollständig isolierte Umgebung: Linux-Benutzer, PHP-FPM-Pool oder Laravel Octane (FrankenPHP) seitdem v5.0, Nginx vhost, Datenbank (standardmäßig MariaDB; optional PostgreSQL seitdem v4.8.0), Supervisor Worker, Crontab-Eintrag, Deployer-Releases ohne Ausfallzeiten, SSH Bereitstellungsschlüssel und automatisch kompiliert .env. Benutzerdefinierte Apps sind einfacher – siehe benutzerdefinierte Apps für Einzelheiten.

Laravel-App (Standard: PHP-FPM)

$ cipi app create

Laravel Octane (FrankenPHP)

$ cipi app create --octane
$ cipi app create --octane=frankenphp   # explicit (same as --octane)

Siehe Laravel Octane für Anforderungen, Konvertierung und wie der vhost unterscheidet sich von FPM.

Nicht interaktiv (Flaggen)

$ cipi app create \
    --user=myapp \
    --domain=myapp.com \
    --repository=git@github.com:you/myapp.git \
    --branch=main \
    --php=8.5

# Laravel Octane (FrankenPHP) — v5.0+
$ cipi app create --user=myapp --domain=myapp.com \
    --repository=git@github.com:you/myapp.git --octane

# optional PostgreSQL (v4.8.0+, after cipi db install pgsql)
$ cipi app create --user=myapp --domain=myapp.com \
    --repository=git@github.com:you/myapp.git --engine=pgsql

Apps

Laravel Octane (FrankenPHP)

Seitdem v5.0, Laravel Apps können HTTP über bereitstellen Laravel Octane mit dem FrankenPHP Server statt pro App PHP-FPM-Pool. Octane und klassische FPM-Apps laufen nebeneinander auf demselben Cipi-Server.

Was Cipi konfiguriert

• Weist einen Localhost-Port zu 8100–8999 und Geschäfte octane / octane_port in apps.json
• Nginx vhost verwendet proxy_pass bis Octane und stellt statische Dateien bereit von current/public — Kein FPM-Pool pro App
• Supervisor Programm ${app}-octane neben Warteschlangenarbeitern
• Bereitstellungsvorlage laravel-octane.php startet / lädt Octane bei der Bereitstellung neu
• .env: OCTANE_SERVER=frankenphp, OCTANE_HTTPS=true

App-Anforderungen

Ihr Laravel-Repository muss enthalten laravel/octane und laufen php artisan octane:install --server=frankenphp. Octane beginnt nach dem ersten erfolgreiche Bereitstellung.

# create an Octane app
$ cipi app create --user=myapp --domain=myapp.com \
    --repository=git@github.com:you/myapp.git --octane

# convert an existing FPM app → Octane (or the reverse)
$ cipi app convert myapp --to=octane
$ cipi app convert myapp --to=fpm

# tune Octane workers (also see app limits)
$ cipi app limits myapp --octane-workers=4

cipi app convert --to=octane|fpm schreibt den Pool / vhost / Supervisor / Deployer neu Vorlage / .envund wendet SSL erneut an, wenn bereits ein Zertifikat vorhanden ist.

cipi app create --custom

Erstellt eine benutzerdefinierte App mit klassischer Bereitstellung (keine Null-Ausfallzeit): Code wird bereitgestellt htdocs – nein current/shared Symlinks. Ideal für statische Websites, SPAs (Vue, React, Svelte), WordPress, andere CMS oder jedes Nicht-Laravel PHP-Projekt oder Framework.

Bei der Erstellung wählen Sie nur das Dokumentstammverzeichnis (Standard). /, oder z.B. www, dist, public). Nginx ist vorkonfiguriert mit index index.html index.php, try_files $uri $uri/ /index.php?$args, und error_page 404 /404.html – keine Eingabeaufforderungen für try_files oder Einstiegspunkt.

Git optional (nur SFTP)

Das Git-Repository ist optional für benutzerdefinierte Apps. Laravel Apps benötigen weiterhin ein Repository. Wenn Sie das Repository für eine benutzerdefinierte überspringen App, Cipi erstellt /home/<app>/htdocs mit einem Platzhalter index.html und tut Konfigurieren Sie keinen Bereitstellungsschlüssel oder webhook – mit dem Sie Dateien hochladen SFTP (oder SCP/rsync) zu ~/htdocs als App-Benutzer. Die Onboarding-Ausgabe erklärt dies „kein Repo – nur SFTP“ Arbeitsablauf. Wenn Sie ein Repository bereitstellen, bleibt das Verhalten unverändert: verwenden cipi deploy <app> Code hineinziehen htdocs.

Was ist enthalten und was Sie hinzufügen

Benutzerdefinierte Apps haben keine Datenbank, Nein .env, nein cron und nein Warteschlangenarbeiter. Wenn ein Repository konfiguriert ist, sind ein Bereitstellungsschlüssel und (mit Git-Auto-Setup) webhook vorhanden gezeigt; Bei reinen SFTP-Apps entfallen diese. In der Zusammenfassung nach der Erstellung werden der SSH-Zugriff und weitere aufgeführt Schritte entsprechend.

Wenn Ihre benutzerdefinierte App eine Datenbank benötigt (z. B. WordPress, Drupal), erstellen Sie eine mit cipi db create --name=<app> nach dem Einsatz. Siehe cipi Datenbank für Backup, Wiederherstellung und Passwortverwaltung.

Mit Git – nicht interaktives Beispiel:

$ cipi app create --custom --user=mysite --domain=mysite.com \
    --repository=git@github.com:you/mysite.git --docroot=dist

Nur SFTP – weglassen --repository und --branch:

$ cipi app create --custom --user=mysite --domain=mysite.com --docroot=dist

Mit einem Repository verwenden cipi deploy <app> einsetzen; Code wird geklont /home/<app>/htdocs.

app list / app show / app edit / app delete

cipi app reverb

Seitdem v5.0, aktivieren Laravel Reverb für Erstanbieter-WebSockets auf a Laravel App. Cipi weist einen Localhost-Port zu 9000–9099, fügt das Programm Supervisor hinzu ${app}-reverb, Proxys Nginx /app an diesen Port und schreibt REVERB_* in .env.

$ cipi app reverb enable myapp
$ cipi app reverb status myapp
$ cipi app reverb disable myapp

cipi app clone

Seitdem v5.0, klonen Sie eine vorhandene Laravel-App in eine neue Staging- (oder Überprüfungs-)App mit eine eigene Domäne. Sets cloned_from in apps.json; tut nicht Kopieren Sie webhook oder Git-IDs.

$ cipi app clone myapp --domain=staging.myapp.com
$ cipi app clone myapp --domain=staging.myapp.com --name=myapp-stg --branch=develop --with-db
$ cipi app clone myapp --domain=staging.myapp.com --no-db

cipi app limits

Seitdem v5.0Legen Sie Ressourcenlimits pro App fest, wobei feste Obergrenzen durch Cipi erzwungen werden.

$ cipi app limits myapp --fpm-max-children=20 --memory-limit=256M
$ cipi app limits myapp --octane-workers=4 --worker-procs=3
$ cipi app limits myapp   # show current limits

app suspend / app unsuspend

Seitdem verfügbar v4.5.8. Nehmen Sie eine App offline, ohne sie zu löschen – nützlich für die Abrechnung Laderäume, Wartungsfenster oder Staging-Standorte, die vollständig abgedunkelt werden sollen. Durch das Anhalten wird der vhost Nginx ausgetauscht eine Statik HTTP 503 Seite bereitgestellt von /var/www/cipi-suspended/.

$ cipi app suspend myapp      # take offline (503 page)
$ cipi app unsuspend myapp    # restore normal vhost

Verhalten

• HTTPS enthalten – certbot klont den Suspensions-Vhost in den :443 Block, daher zeigt HTTPS auch die Offline-Seite an
• Let's Encrypt funktioniert immer noch – die /.well-known/acme-challenge/ Pfad bleibt öffentlich, sodass Zertifikate während der Sperrung ausgestellt oder erneuert werden können
• Überlebt die Vhost-Regeneration – Alias-Änderungen, PHP-Bearbeitungen und SSL-Installationen Respektieren Sie die hängende Flagge
• In Einträgen sichtbar — cipi app list markiert gesperrte Apps; cipi domains anhängt ⏸ suspended in jeder Zeile

Auch erhältlich über die RUHE API (POST /api/apps/{name}/suspend), cipi-cli (apps suspend) und die WHMCS-Modul (Aussetzen / Tasten zum Aufheben der Suspendierung). Erfordert Token-Fähigkeit apps-suspend für API Zugriff.

cipi basicauth

Seitdem verfügbar v4.5.2. Schützen Sie jede App – Laravel oder benutzerdefiniert – hinter einem Nginx Eingabeaufforderung für Benutzername/Passwort. Nützlich zum Staging von Websites, internen Tools oder Apps, die noch nicht bereit sind noch kein öffentlicher Verkehr.

Anmeldeinformationen werden mit gehasht openssl passwd -apr1 (nein apache2-utils benötigt) und darin gespeichert /etc/nginx/cipi-basicauth/<app>.htpasswd; Der aktivierte Zustand lebt in apps.json. Die auth_basic Anweisungen werden pro injiziert location blockieren, sodass der Schutz die vhost-Neugenerierung übersteht (Aliasänderungen, PHP-Änderungen) und in die geklont wird :443 Blockierung durch Certbot – HTTPS ist ebenfalls abgedeckt. ACME-Herausforderungen bleiben bestehen öffentlich, sodass die Ausstellung und Erneuerung von Zertifikaten niemals blockiert wird. Die Basisauthentifizierung wird automatisch entfernt cipi app delete.

ENV-Variablen verwalten

Jeder Laravel App hat eine Single .env Datei wohnhaft bei /home/<app>/shared/.env. Benutzerdefinierte Apps haben keine .env. Es wird währenddessen von Cipi erstellt und vorab gefüllt app create mit der Datenbank Anmeldeinformationen, APP_KEY, APP_URL, Cache-/Sitzungs-/Warteschlangeneinstellungen und die webhook-Token. Die shared/ Das Verzeichnis ist mit jeder Version symbolisch verknüpft, also dasselbe .env ist immer aktiv, unabhängig davon, welche Version aktuell ist.

Interaktiv bearbeiten über CLI

Der sicherste Weg, ENV-Werte zu ändern, ist über Cipi selbst – es öffnet die Datei in Nano als App Benutzer mit den richtigen Berechtigungen:

$ cipi app env myapp

Sparen Sie mit Strg+O dann beenden Sie mit Strg+X. Änderungen werden für neue sofort wirksam Anfragen – für die meisten Werte ist kein Neustart erforderlich. Wenn Sie die Warteschlangenverbindung oder den Cache-Treiber ändern, Starten Sie die Arbeiter neu:

$ cipi worker restart myapp

Nicht interaktive Flags (v5.0.3+)

Seitdem v5.0.3, Skripte, das Panel API und das Web GUI verwalten können.env ohne einen Editor zu öffnen:

$ cipi app env myapp --show
$ cipi app env myapp --show --json
$ cipi app env myapp --get=APP_URL
$ cipi app env myapp --set=APP_DEBUG=false
$ cipi app env myapp --unset=LEGACY_KEY

RUHE: GET|PUT /api/apps/{name}/env (Fähigkeit apps-env, API 1.14+). MCP: AppEnvShow, AppEnvUpdate.

Direkt über SSH bearbeiten

Sie können die Datei auch direkt über SSH als Root oder als App-Benutzer bearbeiten:

# as root
$ nano /home/myapp/shared/.env

# or switch to the app user first
$ su - myapp
$ nano ~/shared/.env

Von Cipi festgelegte Schlüssel-ENV-Variablen

Hinzufügen eigener Variablen

Fügen Sie am Ende der Datei eine beliebige benutzerdefinierte Variable hinzu, wie Sie es normalerweise in einem Laravel-Projekt tun würden. Sie bleiben über Bereitstellungen hinweg erhalten, da die .env wohnt darin shared/ und ist wird nie vom Deployer überschrieben.

# your custom variables
STRIPE_KEY=sk_live_...
STRIPE_SECRET=sk_live_...
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailgun.org

cipi app run

Seitdem v5.0.3, führe a aus auf die Whitelist gesetzt, nicht interaktiv Befehl als App Benutzer – nützlich aus den „App-Befehlen“ CLI, Panel API und Web GUI. Editoren, Pager, Shells und REPLs sind blockiert (nano, vim, less, bash, tinker, …). Interaktive Flaggen (z. B. tail -f, php -a) sind abgelehnt.

$ cipi app run myapp composer install --no-dev
$ cipi app run myapp npm ci
$ cipi app run myapp ls -la shared
$ cipi app run --commands          # list allowed binaries
$ cipi app run --commands --json

Zu den zulässigen Binärdateien gehören: composer, npm/npx/yarn/pnpm, ls/ll, cat/head/tail, Dateisystem Helfer, Archive, git, php, node, und find. RUHE: POST /api/apps/{name}/run (asynchroner Job, Fähigkeit apps-run) und GET /api/run-commands (API 1.14+). MCP: AppRun, AppRunCommands.

cipi app logs

Tail-Anwendungsprotokolle in Echtzeit. Die Protokolle werden täglich gewechselt und 14 Tage lang aufbewahrt. Von Standardmäßig werden alle Protokolle angezeigt, einschließlich der täglichen Protokolle Laravel (laravel-YYYY-MM-DD.log) von shared/storage/logs/.

$ cipi app logs myapp                  # all logs (incl. Laravel daily logs)
$ cipi app logs myapp --type=nginx     # Nginx access + error
$ cipi app logs myapp --type=php       # PHP-FPM errors
$ cipi app logs myapp --type=worker    # queue worker output
$ cipi app logs myapp --type=deploy    # deploy history
$ cipi app logs myapp --type=laravel   # Laravel application logs

app artisan & app tinker

Führen Sie Artisan-Befehle und Tinker als App-Benutzer mit der richtigen PHP-Version aus und open_basedir Kontext – genau so, wie sie während einer Bereitstellung ausgeführt würden.

$ cipi app artisan myapp migrate:status
$ cipi app artisan myapp queue:retry all
$ cipi app artisan myapp db:seed --class=ProductionSeeder
$ cipi app artisan myapp cache:clear
$ cipi app tinker myapp

SSH als App-Benutzer

Jede App läuft unter einem eigenen isolierten Linux-Benutzer. Manchmal muss man direkt darin arbeiten Benutzerumgebung – überprüfen Sie Dateien, führen Sie einmalige Skripts aus oder debuggen Sie etwas, das nur als reproduziert wird der richtige Benutzer.

Direktes SSH als App-Benutzer (empfohlen)

App-Benutzer können mit dem bei der App-Erstellung generierten Passwort direkt eine SSH-Verbindung zum Server herstellen:

# connect as the app user (password auth)
$ ssh myapp@your-server-ip

# you are directly inside the app user's shell
myapp@server:~$ pwd
/home/myapp

myapp@server:~$ cd ~/current
myapp@server:~$ ls

Das Passwort wird angezeigt, wenn die App erstellt (oder verwendet) wird cipi app reset-password myapp zu regenerieren). Dies funktioniert für SFTP-Clients, IDE-Remotesitzungen und Terminalzugriff.

Über cipi (Administratorpfad)

Wenn Sie bereits als verbunden sind cipikönnen Sie direkt zu jedem App-Benutzer wechseln:

$ ssh cipi@your-server-ip
cipi@server:~$ sudo su - myapp

myapp@server:~$ pwd
/home/myapp

Setzen Sie das App-Benutzerkennwort zurück

Wenn Sie das Passwort eines App-Benutzers neu generieren müssen (z. B. für direktes SSH oder SFTP), verwenden Sie:

$ cipi app reset-password myapp

Das neue Passwort wird auf dem Bildschirm angezeigt – speichern Sie es sofort.

Nützliche Befehle, sobald Sie als App-Benutzer angemeldet sind

# navigate to the active release
myapp@server:~$ cd ~/current

# run artisan directly with the correct PHP version
myapp@server:~$ /usr/bin/php8.5 ~/current/artisan tinker

# inspect the shared .env
myapp@server:~$ cat ~/shared/.env

# tail all logs
myapp@server:~$ tail -f ~/logs/*.log

# check active releases (ll is a built-in alias for ls -al)
myapp@server:~$ ll ~/releases/

Jeder App-Benutzer .bashrc definiert ein Handy ll='ls -al' Alias (seit v4.5.5) für schnellere Verzeichniseinträge über SSH, neben dem deploy und composer Verknüpfungen. Apps, die vor 4.5.5 erstellt wurden, erhalten das ll Alias automatisch beim nächsten Mal cipi self-update über die 4.5.5 Migration.