From 0ec9f3664a7f28aded104f1a8aad3f7754bd8011 Mon Sep 17 00:00:00 2001
From: boban <boban@git.bave.dev>
Date: Thu, 25 Jun 2026 19:52:13 +0200
Subject: [PATCH] feat(terminal): explain the host-login HOST/IP default in the
 setup modal
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The field is pre-filled with host.docker.internal — a Docker DNS name that resolves to
the machine the containers run on (the Clusev host) — but had no explanation, so it read
as a mandatory magic value. Add a one-line helper under the field: it's the default for
the Clusev host; leave it, or enter another IP/host. The field stays editable on purpose
(some setups want the host's LAN IP or a different machine).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 lang/de/terminal.php                                 | 1 +
 lang/en/terminal.php                                 | 1 +
 resources/views/livewire/modals/host-shell.blade.php | 1 +
 3 files changed, 3 insertions(+)

diff --git a/lang/de/terminal.php b/lang/de/terminal.php
index 7dee464..c8c9db9 100644
--- a/lang/de/terminal.php
+++ b/lang/de/terminal.php
@@ -29,6 +29,7 @@ return [
     'host_setup_title' => 'Clusev-Host-Login',
     'host_setup_subtitle' => 'SSH-Zugang zum Clusev-Host. Damit wird das Terminal ein echtes Login auf der Maschine — kein Container.',
     'host_field_host' => 'Host / IP',
+    'host_field_host_hint' => 'Standard: die Maschine, auf der Clusev läuft (Docker-Host). So lassen — oder eine andere IP/Host eintragen.',
     'host_field_port' => 'Port',
     'host_field_user' => 'Benutzer',
     'host_field_auth' => 'Authentifizierung',
diff --git a/lang/en/terminal.php b/lang/en/terminal.php
index 05716ac..e8ee508 100644
--- a/lang/en/terminal.php
+++ b/lang/en/terminal.php
@@ -29,6 +29,7 @@ return [
     'host_setup_title' => 'Clusev host login',
     'host_setup_subtitle' => 'SSH access to the Clusev host. This makes the terminal a real login on the machine — not a container.',
     'host_field_host' => 'Host / IP',
+    'host_field_host_hint' => 'Default: the machine Clusev runs on (the Docker host). Leave it — or enter another IP/host.',
     'host_field_port' => 'Port',
     'host_field_user' => 'User',
     'host_field_auth' => 'Authentication',
diff --git a/resources/views/livewire/modals/host-shell.blade.php b/resources/views/livewire/modals/host-shell.blade.php
index 305f0b0..60eca0c 100644
--- a/resources/views/livewire/modals/host-shell.blade.php
+++ b/resources/views/livewire/modals/host-shell.blade.php
@@ -16,6 +16,7 @@
                 <input wire:model="host" type="text" placeholder="host.docker.internal"
                        class="h-9 w-full rounded-md border border-line bg-inset px-3 font-mono text-sm text-ink placeholder:text-ink-4 focus:border-accent/40 focus:outline-none" />
                 @error('host')<p class="mt-1 flex items-center gap-1.5 font-mono text-[11px] text-offline"><x-icon name="alert" class="h-3.5 w-3.5 shrink-0" />{{ $message }}</p>@enderror
+                <p class="mt-1.5 font-mono text-[11px] leading-relaxed text-ink-4">{{ __('terminal.host_field_host_hint') }}</p>
             </div>
             <div>
                 <label class="mb-1 block font-mono text-[11px] uppercase tracking-wider text-ink-3">{{ __('terminal.host_field_port') }}</label>