Clusev ist ein selbst-gehostetes Control-Panel, um eine Flotte von Linux-Servern aus einem
+ Dashboard zu verwalten — agentenlos über SSH. Es installiert nichts auf den Zielservern, sondern steuert sie
+ direkt (Befehle + Dateien über SSH). Die ganze Oberfläche ist sicherheitsorientiert: 2FA, verschlüsselter
+ SSH-Zugangsdaten-Tresor und ein vollständiges Audit-Log.
+
+
+
+
Erster Login
+
Nach der Installation meldest du dich mit der Admin-E-Mail und dem Standard-Passwort
+ clusev an (die Standard-E-Mail ist admin@clusev.local,
+ sofern beim Installieren keine andere gesetzt wurde). Das Panel erzwingt sofort einen
+ Passwortwechsel — `clusev` ist ein bekanntes Standard-Passwort und nur bis zur Änderung gültig. Ändere es
+ gleich beim ersten Login.
+
+
+
+
Zugriff: Bare-IP oder Domain
+
+
Ohne Domain (Bare-IP): erreichbar über
+ http://<Server-IP> per Klartext-HTTP. Diese Adresse bleibt immer als
+ Wiederherstellungsweg erreichbar, auch wenn später eine Domain eingerichtet wird.
+
Mit Domain: entweder mit eingebautem TLS (Let's Encrypt,
+ automatisch) oder hinter einem externen Reverse-Proxy. Details im Thema „Domain, TLS & Reverse-Proxy".
+
+
+
+
+
Wo finde ich was?
+
+
Dashboard: Live-Metriken der Flotte.
+
Server / Dienste / Dateien: Server-Details, systemd-Dienste, SFTP-Dateimanager.
Clusev is a self-hosted control panel for managing a fleet of Linux servers from one dashboard —
+ agentless, over SSH. It installs nothing on the target servers; it drives them directly (commands + files over
+ SSH). The whole interface is security-first: 2FA, an encrypted SSH-credential vault and a complete audit log.
+
+
+
+
First login
+
After installation, sign in with the admin e-mail and the default password
+ clusev (the default e-mail is admin@clusev.local
+ unless another was set at install time). The panel forces a password change immediately —
+ `clusev` is a known default and only valid until you change it. Change it right away on first login.
+
+
+
+
Access: bare IP or a domain
+
+
No domain (bare IP): reachable at
+ http://<server-ip> over plain HTTP. This address always stays reachable
+ as a recovery path, even after a domain is configured.
+
With a domain: either built-in TLS (Let's Encrypt,
+ automatic) or behind an external reverse proxy. See the "Domain, TLS & reverse proxy" topic.
System: domain, TLS & restart. Version: updates. Help: this page.
+
+
Tip: Ctrl/⌘ K opens the command search; g + a letter jumps directly (e.g. g h = Help).
+
diff --git a/resources/views/livewire/help/index.blade.php b/resources/views/livewire/help/index.blade.php
new file mode 100644
index 0000000..d62c41c
--- /dev/null
+++ b/resources/views/livewire/help/index.blade.php
@@ -0,0 +1,35 @@
+@php
+ // Resolve the content partial for the active locale; fall back to German if an EN partial
+ // is missing, so a not-yet-translated topic never breaks the page.
+ $locale = in_array(app()->getLocale(), ['de', 'en'], true) ? app()->getLocale() : 'de';
+ $partial = 'livewire.help.content.'.$locale.'.'.$topic;
+ if (! view()->exists($partial)) {
+ $partial = 'livewire.help.content.de.'.$topic;
+ }
+@endphp
+
+
+
+
{{ __('help.eyebrow') }}
+
{{ __('help.heading') }}
+
{{ __('help.subtitle') }}
+
+
+
+ {{-- Topic navigation (wraps above the content on small screens) --}}
+
+
+ {{-- Content --}}
+
+ @include($partial)
+
+
+
diff --git a/routes/web.php b/routes/web.php
index ea3f3c3..9f641be 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -6,6 +6,7 @@ use App\Livewire\Audit;
use App\Livewire\Auth;
use App\Livewire\Dashboard;
use App\Livewire\Files;
+use App\Livewire\Help;
use App\Livewire\Servers;
use App\Livewire\Services;
use App\Livewire\Settings;
@@ -104,5 +105,6 @@ Route::middleware('auth')->group(function () {
Route::get('/settings', Settings\Index::class)->name('settings');
Route::get('/versions', Versions\Index::class)->name('versions');
Route::get('/system', System\Index::class)->name('system');
+ Route::get('/help', Help\Index::class)->name('help');
});
});
diff --git a/tests/Feature/HelpPageTest.php b/tests/Feature/HelpPageTest.php
new file mode 100644
index 0000000..0b4db15
--- /dev/null
+++ b/tests/Feature/HelpPageTest.php
@@ -0,0 +1,39 @@
+actingAs(User::factory()->create(['must_change_password' => false]));
+ }
+
+ public function test_help_route_loads_for_an_authenticated_admin(): void
+ {
+ $this->actAsAdmin();
+ $this->get('/help')->assertOk();
+ }
+
+ public function test_default_topic_is_overview(): void
+ {
+ $this->actAsAdmin();
+ Livewire::test(Index::class)
+ ->assertSet('topic', 'overview')
+ ->assertSee(__('help.topic_overview'));
+ }
+
+ public function test_unknown_topic_falls_back_to_overview(): void
+ {
+ $this->actAsAdmin();
+ Livewire::test(Index::class, ['topic' => 'bogus'])->assertSet('topic', 'overview');
+ }
+}