Konfiguration

Für eine verwaltete Instanz wird die Präferenz Umweltvariablen → Instance config → globale Benutzerkonfiguration → Standard. aircode start -Optionen bleiben in der Instance-Konfiguration bestehen, bevor der Dienst gestartet wird. Vorhergehende aircode serve -Optionen übertreffen nur die Umgebung für diesen Prozess.

Die globale Datei ist ~/.config/aircode/config.json. Managed instance files live auf ~/.config/aircode/instances/<id>.json; sie werden nicht in Projektverzeichnissen platziert. Geheime Dateien verwenden den Modus 0600. Die nativen Windows Vordergrundoptionen sind in der Windows CLI Referenzaufgeführt.

Per-Instance-Start-Konfiguration

aircode start --projects-root /srv/workspaces --host 127.0.0.1 --port 7860 \
  --password-file ~/.config/aircode/workspaces-password

Dedizierte Flaggen decken Wurzel, Name, Host, Port, öffentliche URL, jeden Passwort-Eingabe-Modus und Relay ab. Jeder zusätzliche schemaunterstützte Wert kann mit einem wiederholbaren --set key=valuebestehen; Werte verwenden JSON , wenn gültig:

aircode start --set maxSessions=64
aircode start --set workflows.maxConcurrent=2
aircode start --set 'browserAllowedHosts=["docs.example.com","*.internal.test"]'

Verwenden Sie --json für die unbeaufsichtigte Bereitstellung. Seine Ausgabe enthüllt niemals ein vorhandenes Passwort; es enthält ein Passwort nur, wenn diese Einladung es generiert hat.

Allgemeine Einstellungen

Env	config.json	Standard	Zweck
`AIRCODE_HOST`	`host`	Tailscale IP, anderweitig `127.0.0.1`	Bind-Adresse (nicht `0.0.0.0` standardmäßig)
`AIRCODE_PORT`	`port`	`7860` (Auto-Scan für eine neue Instanz)	Port für die Ein anhaltender oder explizit eingestellter geschäftiger Port scheitert statt zu verschieben
`AIRCODE_AUTH_PASSWORD`	`authPassword`	generiert	Passwort für den Zugriff. Leere Zeichenfolge deaktiviert auth (dev only)
`AIRCODE_PROJECTS_ROOT`	`projectsRoot`	Start cwd	Verzeichnis, dessen Unterordner ausgewählbare Projekte sind
`AIRCODE_MAX_SESSIONS`	`maxSessions`	`64`	Gleichzeitige Sitzungskappe
`AIRCODE_SESSION_IDLE_TTL_MS`	`sessionIdleTtlMs`	`21600000`	Hibernate abgeschlossen Sitzungen nach 6 Stunden untätig; `0` deaktiviert auch Kapazitätsentfernung
`AIRCODE_DEFAULT_PERMISSION_MODE`	`defaultPermissionMode`	`bypass`	Default Agent Permission Modus
`AIRCODE_DEFAULT_EXECUTION_MODE`	`defaultExecutionMode`	`local`	Standard-Sitzungsumgebung (`local` oder `docker`)
`AIRCODE_DOCKER_ENABLED`	`dockerEnabled`	`true`	Exponieren Sie das optionale Docker -Ausführungs-Backend
`AIRCODE_DOCKER_IMAGE`	`dockerImage`	`aircode-session-runtime:local`	Optional Docker Arbeiterbild
`AIRCODE_DOCKER_NETWORK`	`dockerNetwork`	`aircode-runtime`	Dedicated Worker Bridge (Dedizierte Arbeiterbrücke)
`AIRCODE_DOCKER_CONTROL_PORT`	`dockerControlPort`	AirCode Ø Port + 1000	Stabile Kapazitätsbeschränkungen für Arbeitnehmer
—	`updateChannel`	`stable`	Release-Kanal (`stable` / `beta`)

Die Session-Hibernation stoppt nur abgetrennte Laufzeiten, deren letzte Wendung einen dauerhaften Finish-Marker und eine wiederholbare Transkription hat. Sitzungen, die ausgeführt werden, auf Eingabe warten, aus der Ferne gesteuert werden oder von einem Workflow gehalten werden, bleiben ausgeführt. Bei der Sitzungskappe hiberniert AirCode Ø sofort die älteste qualifizierte Laufzeit. Das Gespräch bleibt in der Geschichte und geht normal weiter.

Die Engine-Binare (claudeBin, codexBin, …) und die Einstellungen pro Funktion (Browser, Wissen, Orchestrierung, Token-Optimierung) werden in den in-Produkt-Einstellungen dokumentiert und akzeptieren die gleiche env/file Vorrang.

Siehe Docker Sandbox für Arbeitnehmerlimits, Netzwerke und die komplette Docker -Konfiguration.

Dateien & Verzeichnisse

Weg	Inhalt
`~/.aircode/versions/<v>`	das Produkt (immutable, checksummed)
`~/.aircode/current`	Symlink zur aktiven Version
`~/.config/aircode/config.json`	globale Benutzerdefinitionen
`~/.config/aircode/instances/<id>.json`	pro Instance-Konfiguration, einschließlich des Passworts (0600)
`~/.config/aircode/providers.env`	Provider-Authentifizierungen, die vom Unix-Benutzer geteilt werden (0600)
`~/.config/systemd/user/aircode@.service`	eine generierte systemd-Vorlage für jede verwaltete Instanz
`~/.local/state/aircode/instances/<id>/`	Isolierte Laufzeit, Tunnel und Sitzungsstatus
`~/.local/state/aircode/relay-account.json`	verwaltete Relay -Kontoanmeldeinformationen, die vom Unix-Benutzer geteilt wurden (0600)

Aktualisierungen berühren nie die Instance config oder den Status.

Mehrere Instanzen

Die kanonische Wurzel bestimmt die Standardidentität. Verschiedene Wurzeln produzieren natürlich unterschiedliche Fälle. Für eine Wurzel erstellt oder verwendet ein anderer expliziter Port eine unabhängige, automatisch benannte Instanz, anstatt die Standardinstanz zu ändern und neu zu starten. --name liefert eine stabile, rollorientierte Identität, wenn Sie sie benötigen. Jede Instanz erhält einen eigenen Port, eine eigene Passwort- / Passwortlos-Richtlinie, den Namensraum tmux , den Status und die Tunnel-Identität.

aircode start --projects-root /srv/acme --port 7860 --generate-password
aircode start --projects-root /srv/acme --port 7861 --no-password --relay private
aircode start --projects-root /srv/acme --name demo --port 7862 --generate-password
aircode ps -a

Um den Port einer vorhandenen Instanz zu ändern, wählen Sie diese Instanz explizit nach Namen oder ID aus. Ein Wurzelkommando mit einem neuen Port wird absichtlich als neue Instanz behandelt, so dass es den aktuellen Server nicht stillschweigend offline nehmen kann.

Lebenszyklus-Befehle akzeptieren den Namen, den vollständigen oder kurzen ID, die kanonische Wurzel oder den aktuellen Verzeichnis. Ein Wurzelselektor wird absichtlich als zweideutig abgelehnt, wenn mehrere benannte Instanzen ihn verwenden; wählen Sie den Namen oder ID aus.

Mehrbenutzermaschinen

Jeder OS-Benutzer besitzt ein separates Register, globale Standards, Anbieter-Authentifizierungen, verwaltete Relay -Authentifizierung und eine Reihe von systemd-Benutzerdiensten. Innerhalb dieses Benutzers hat jede instanz, die den Pfad betrifft, immer noch ihren eigenen port, Passwort, status und Sitzungen. aircode start erstellt und aktiviert die richtige Vorlageinstanz; der ältere Befehl aircode service install wird nur für die Kompatibilität beibehalten.

Kostenloser Produktzugriff

Das selbstverwaltete Produkt erfordert keinen Produktschlüssel, keine Aktivierung, keine Karte oder keine Testversion. Es bleibt vollständig offline nutzbar und beschränkt die Sitzungsstartzeiten nicht, wenn eine alte Lizenz oder ein Testprotokoll abläuft.

Der Befehl aircode license wird nur so beibehalten, dass historische Installationen veraltete Datensätze überprüfen oder entfernen können. Diese Aufzeichnungen ändern den aktuellen Produktzugang nicht. Siehe Downloads für die separaten Kontoanforderungen des verwalteten Relay und der Marketplace-Aktionen.