filex-Logo # filex **Selbst gehosteter Dateimanager mit Freigaben und Weboberfläche, in einer einzigen Go-Binärdatei - eine Open-Source-Alternative zu Nextcloud, Dropbox und Google Drive.**
Webbasierter Dateibrowser für lokalen, S3-, SFTP-, WebDAV-, FTP- und SMB-Speicher: eine private Cloud, bereitgestellt als S3, SFTP, NFS, WebDAV.
SSO/LDAP, mandantenfähig, verschlüsselte Ordner, einbettbare Webkomponente, Desktop-App, MCP-Server. [![Live-Demo ausprobieren](https://img.shields.io/badge/Try_the_live_demo-f59e0b?style=for-the-badge)](https://demo.filex.sh) [![Schnellstart](https://img.shields.io/badge/Quick_start-2f6ceb?style=for-the-badge)](#schnellstart) [![Dokumentation](https://img.shields.io/badge/Documentation-374151?style=for-the-badge)](https://docs.filex.sh) [![Release](https://img.shields.io/github/v/release/BRF-Tech/filex?color=2f6ceb)](https://github.com/BRF-Tech/filex/releases) [![License: MIT](https://img.shields.io/github/license/BRF-Tech/filex?color=22c55e)](LICENSE) [English](README.md) · [Türkçe](README.tr.md) · **Deutsch** · [Español](README.es.md) · [Français](README.fr.md) · [简体中文](README.zh-CN.md) Dies ist eine Übersetzung der [englischen README](README.md); wo die beiden voneinander abweichen, gilt der englische Text. Sie wurde maschinell übersetzt, eine Durchsicht durch Muttersprachler steht noch aus - Korrekturen sind willkommen. Die Dokumente, auf die sie verweist, sind auf Englisch. filex-Explorer - Raster mit Vorschaubildern
**🗂️ Jeder Speicher, ein Baum** Binden Sie nebeneinander ein, was Sie schon haben, und kopieren oder schneiden Sie in einem Speicher aus und fügen Sie in einem anderen ein. Lassen Sie `rclone`, `restic`, WinSCP oder FileZilla auf denselben Baum zeigen. [Speicher und Protokolle →](#speicher-und-protokolle) **🔗 Teilen und schützen** Links mit PIN, Ablaufdatum und Download-Limit. Papierkorb, Versionsverlauf und Ende-zu-Ende-verschlüsselte Ordner. [Freigaben und Schutz →](#freigaben-und-schutz)
**🔑 Ihre Konten, Ihre Rollen** OIDC, LDAP / Active Directory oder die Windows- und Linux-Konten des Servers. Rollen, Gruppen, mandantenfähig. [Personen und Zugriff →](#personen-und-zugriff) **💻 Eine Desktop-App mit Live-Ordner-Sync** Windows, Linux und macOS (Apple Silicon): Eine Änderung auf der einen Seite ist in etwa einer Sekunde auf der anderen. [Desktop-App & CLI →](#desktop-app--cli)
**🧩 Lässt sich in Ihr Produkt einbetten** Dieselbe Oberfläche als Vue-3-Komponente, als React-Komponente und als Webkomponente ``. [In Ihre Anwendung einbetten →](#in-ihre-anwendung-einbetten) **🤖 Apps und KI-Agenten** Apps in einer Sandbox - E-Signatur, Konvertieren, draw.io - und ein integrierter MCP-Server, den ein Agent steuern kann. [Apps →](#apps) · [KI-Agenten / MCP →](#ki-agenten--mcp)

Warum filex · Umstieg von einem anderen Werkzeug · Selbst hosten · Funktionen


# Schnellstart > [!TIP] > **Erst ansehen, dann installieren:** [demo.filex.sh](https://demo.filex.sh) - melden Sie sich mit > `demo@demo.com` / `demo` an (Admin-Rolle, Sandbox wird jede Nacht zurückgesetzt). Starten Sie Ihre eigene Instanz, aus dem Ordner, den Sie bereitstellen wollen: ```bash docker run -p 5212:5212 \ -e FILEX_DEFAULT_STORAGE_DRIVER=local -e FILEX_DEFAULT_STORAGE_PATH=/srv/files \ -v filex-data:/data -v "$PWD:/srv/files" \ ghcr.io/brf-tech/filex:latest ``` Öffnen Sie http://localhost:5212/admin - der erste Start gibt Admin-Anmeldedaten und eine Anleitung zum Einbetten auf der Konsole aus. Diese URL gehört dem Betreiber; die Personen, denen Sie ein Konto geben, bekommen **http://localhost:5212/drive**, denselben Dateimanager ohne den Adminbereich darum herum.
Was dieser Befehl einbindet und als welcher Benutzer er läuft Das stellt **den Ordner bereit, in dem Sie es gestartet haben** - öffnen Sie die Oberfläche, und Ihre Dateien sind schon da. `/data` ist das eigene Verzeichnis von filex (SQLite-Datenbank, Suchindex, Vorschaubild-Cache), deshalb ist es ein benanntes Volume und nicht der Ordner, in dem Sie Dateien ablegen; beides ist absichtlich getrennt. Lassen Sie `$PWD` auf einen anderen Ort zeigen, oder fügen Sie später im Adminbereich weitere Speicher hinzu - ein Bucket mit mehreren Ordnern der obersten Ebene lässt sich in einem Schritt als je ein Speicher pro Ordner einbinden (*Speicher → Speicher hinzufügen → Mehrere Ordner auf einmal einbinden*). Der Container läuft standardmäßig als **root**, daher gehört alles, was er in `/data` schreibt, root; setzen Sie `PUID`/`PGID`, damit er als Ihr eigener Benutzer läuft ([docs/DOCKER.md](docs/DOCKER.md#which-user-the-container-runs-as)).
Kein Docker? Starten Sie die Binärdatei Laden Sie das Archiv für Ihre Plattform aus dem [neuesten Release](https://github.com/BRF-Tech/filex/releases/latest) herunter, entpacken Sie es und starten Sie die Binärdatei ([docs/INSTALLATION.md](docs/INSTALLATION.md#binary)): ```bash # Download from https://github.com/BRF-Tech/filex/releases ./filex serve ``` ``` ═══════════════════════════════════════════════════════════════ filex · self-hosted file manager ═══════════════════════════════════════════════════════════════ Listening on: http://0.0.0.0:5212 Admin UI: http://0.0.0.0:5212/admin Files UI: http://0.0.0.0:5212/drive Embed JS: http://0.0.0.0:5212/embed.js First run detected. Initial admin user created: Email: admin@local Password: Saved to: ~/.filex/.first-run.txt (mode 0600, shown ONCE) Change at: /admin/dashboard?settings=1 ═══════════════════════════════════════════════════════════════ ```
Für eine produktive Installation gibt es Compose-Stacks und ein Helm-Chart: [Selbst hosten mit Compose oder Helm](#selbst-hosten-mit-compose-oder-helm). Das Image liegt auf [GitHub Packages](https://github.com/BRF-Tech/filex/pkgs/container/filex).
# Warum filex Die meisten selbst gehosteten Dateimanager sind entweder **zu klein** (eine Verzeichnisliste mit Uploads) oder **zu groß** (eine Groupware-Suite, die man wegen des Datei-Tabs installiert). filex zielt auf die Lücke dazwischen. Der Rundgang unten hat acht Teile, jeder mit seinen Screenshots darunter eingeklappt. Jede Funktion im Detail, mit ihren Grenzen und der Anleitung, die sie beschreibt, steht in [docs/FEATURES.md](docs/FEATURES.md).
## Der Explorer **Ein Dateimanager, den man schon zu bedienen weiß.** - Ein Navigationsbereich mit **Start · Meine Dateien · Mit mir geteilt · Meine Freigaben · Zuletzt verwendet · Favoriten · Entwürfe · Papierkorb**; Listen-, Raster- und Galerieansicht; Tabs, Tags und eine ⌘K-Befehlspalette. - Anwesenheits-Avatare und Dateiänderungen kommen live an, über WebSocket. - Stellen Sie ein Design in Ihren eigenen Farben zusammen und machen Sie es zum Standard: Die Anmeldeseite und jeder öffentliche Link tragen es ebenfalls, und ein Smartphone installiert die Web-App unter dem Namen und dem Logo Ihrer Instanz. - Englisch und Türkisch sind eingebaut, weitere Sprachen werden als Pakete installiert, und für Sprachen, die so gelesen werden, richtet sich die Oberfläche von rechts nach links aus. Alle Funktionen des Explorers im Detail: [docs/FEATURES.md → The explorer](docs/FEATURES.md#the-explorer).

Die filex-Shell

Screenshots des Explorers - die Shell, die Suche, die Navigation, Tags, der Papierkorb, die Glocke, Designs, Symlinks, CSV in ONLYOFFICE
![Die filex-Shell](https://filex.sh/shots/driveshell/driveshell-hero-1440.6410104e072c.png) Die Shell - wo alle landen ![Einen Ordner durchsuchen](https://filex.sh/shots/driveshell/driveshell-search-1440.2536c373425f.png) Diesen Ordner durchsuchen; `⌘K` / `Ctrl K` übergibt die Suchanfrage an die Befehlspalette
![Navigationsbereich](https://filex.sh/shots/sidenav/sidenav-expanded-1440.e96ea7e98388.png) Navigationsbereich - Start, Mit mir geteilt, Meine Freigaben, Zuletzt verwendet, Favoriten, Papierkorb und die Speicher, die Sie erreichen können ![Zu einer Leiste eingeklappt](https://filex.sh/shots/sidenav/sidenav-rail-1440.9269e026d29a.png) Zur Icon-Leiste eingeklappt
![Persönliche Tags und Team-Tags](https://filex.sh/shots/tags/tags-kinds-1440.a4504c43e5cb.png) Tags - Ihre eigenen oder die Ihres Teams; ein Tag öffnet alle Dateien, die es tragen, aus allen Ordnern, in denen sie liegen ![Die Ansicht „Papierkorb“](https://filex.sh/shots/sidenav/view-trash-1440.40f8904b147f.png) Papierkorb - was gelöscht wurde, woher es kam und wie viel Zeit bleibt, bis es verschwindet
![Die Glocke mit ihrem Badge für Ungelesenes, geöffnet](https://filex.sh/shots/signing/bell-badge-1440.e9232b261511.png) Die Glocke - darauf die Zahl der ungelesenen Benachrichtigungen, jede Zeile führt an den Ort, den sie nennt ![Die vollständige Liste der Benachrichtigungen über dem Explorer](https://filex.sh/shots/signing/notifications-list-1440.669ce56b62d7.png) Alle Ihre Benachrichtigungen, im Explorer - für alle, nicht nur für Administratoren
![Der Design-Editor](https://filex.sh/shots/appearance/theme-editor-1440.867a94807e72.png) Darstellung - stellen Sie ein Design in Ihren eigenen Farben zusammen, mit Vorschau, während Sie tippen ![Der Explorer trägt das Design des Betreibers](https://filex.sh/shots/appearance/themed-explorer-1440.abc278616daa.png) Ist es als Standard festgelegt, trägt es der Explorer bei allen…
![Die Anmeldeseite trägt das Design des Betreibers](https://filex.sh/shots/appearance/themed-signin-1440.58769eb1f1d4.png) …und die Anmeldeseite, bevor sich irgendjemand angemeldet hat ![Ein Symlink, der den Speicher verlässt, gekennzeichnet](https://filex.sh/shots/symlinks/symlink-badge-1440.82a105d4239e.png) Ein Symlink, dem filex nicht folgt, sagt das - in der Dateiliste und in Worten in seinen Details
![Eine CSV-Datei mit Semikolon als Trennzeichen, in der Tabellenkalkulation von ONLYOFFICE geöffnet](https://filex.sh/shots/csvoffice/csv-view-1440.83237ba55d3d.png) Eine `.csv`-Datei öffnet sich in der Tabellenkalkulation von ONLYOFFICE, wenn eines angebunden ist - zuerst zum Ansehen und ohne Dialog für das Trennzeichen: Das eigene Trennzeichen der Datei wird mitgegeben ([CSV-Dateien](docs/ONLYOFFICE.md#csv-files)) ![Die CSV-Datei im Editor von ONLYOFFICE, mit dem Hinweis, was beim Speichern erhalten bleibt](https://filex.sh/shots/csvoffice/csv-edit-1440.4efc379a293d.png) …und ihr Editor, der sagt, was beim Speichern als CSV erhalten bleibt; die Datei geht als dieselbe Art von CSV zurück, und Zellen, die niemand geändert hat, behalten ihren Text - `007` bleibt `007` ([unveränderte Zellen](docs/ONLYOFFICE.md#cells-nobody-changed-keep-their-text))

## Speicher und Protokolle **Jeder Speicher in einem Baum, und dieser Baum ist von überall erreichbar.** - Binden Sie lokale Datenträger, S3, FTP, SFTP, WebDAV und SMB/NAS-Freigaben nebeneinander ein, und kopieren oder schneiden Sie in einem aus und fügen Sie in einem anderen ein; für einen Speicher, den filex nicht mitliefert, installieren Sie ein Plug-in aus dem Adminbereich oder über den Link eines App-Stores. - Was an filex vorbei geschrieben wird, erscheint: Ein lokaler Ordner wird live überwacht, also wird, was die Freigabe des NAS oder eine andere App dort schreibt, beim Öffnen des Ordners aufgelistet, nicht erst beim nächsten Scan; liegt die Festplatte auf einem anderen Rechner, läuft dort [filex-watch](docs/FILEX-WATCH.md) und meldet geänderte Ordner in Sekunden. - Erreichen Sie denselben Baum als **S3**, **SFTP**, **FTPS**, **NFSv3** und **WebDAV**: Lassen Sie `rclone`, `restic`, `aws s3`, WinSCP oder FileZilla darauf zeigen. Es gelten dieselben filex-Berechtigungen (pro Person, Gruppe und Ordner), derselbe Papierkorb und dasselbe Kontingent wie in der Weboberfläche; die POSIX-Bits und ACLs auf dem Datenträger werden keinen filex-Benutzern zugeordnet. - `filex mount` bindet einen entfernten Server über gewöhnliches HTTPS ein: als Ordner unter Linux, als Laufwerksbuchstabe unter Windows (macOS wird nicht unterstützt). Alle Funktionen zu Speicher und Protokollen im Detail: [docs/FEATURES.md → Storage and protocols](docs/FEATURES.md#storage-and-protocols).

So verbinden Sie sich

Screenshots zu Speicher und Protokollen - die Verbindungsanleitungen, API-Schlüssel, ein Speicher-Plug-in und filex-watch
![So verbinden Sie sich](https://filex.sh/shots/sidenav/connect-1440.45536274e7dc.png) So verbinden Sie sich - die Anleitungen, aus *Ihrer* Installation erzeugt ![API-Schlüssel](https://filex.sh/shots/sidenav/apikeys-minted-1440.c7e147b4cebb.png) API-Schlüssel - erstellen Sie Ihre eigenen, im Explorer oder in einer Einbettung (Sitzung oder Schlüssel einer Person; eine Einbettung, die über einen Proxy mit einem gemeinsamen *App*-Schlüssel läuft, bekommt diesen Eintrag nicht)
![Verbindungsanleitung](https://filex.sh/shots/connections-guide.3999cf32c3d9.png) filex von allem aus erreichen - S3, SFTP, FTPS, NFS, WebDAV. Jeder Befehl wird aus *Ihrer* Installation erzeugt ![Plug-ins](https://filex.sh/shots/admin-plugins.6bd96bf65745.png) Ein Speicher, den filex nicht mitliefert - unter **Plug-ins → Speicher-Plug-ins** als Plug-in installiert, das sein eigenes Konfigurationsformular beschreibt
![Die filex-watch-Karte auf der Seite eines Speichers: ein nur einmal angezeigter Schlüssel und die Befehle, die den Agenten installieren](https://filex.sh/shots/filexwatch/filex-watch-key-1440.64f0c29c10da.png) filex-watch - ein Schlüssel für den Rechner, dem die Festplatte eines Speichers gehört, nur einmal angezeigt, mit den Befehlen, die den Agenten unter Linux, Docker, Windows oder macOS installieren ![Die filex-watch-Karte mit gemeldetem Agenten: Version, Host, Ordner und letzte Meldung](https://filex.sh/shots/filexwatch/filex-watch-1440.7e366ab5405b.png) Dieselbe Karte, sobald der Agent meldet: was der Agent jedes Rechners zuletzt gesagt hat, und wann

## Freigaben und Schutz **Teilen Sie mit einem Link, den Sie begrenzen und widerrufen können. Machen Sie ein versehentliches Löschen oder Überschreiben rückgängig.** - Öffentliche Links mit PIN, Ablaufdatum und Download-Limit, Dateianforderungen für das, was hereinkommen soll, und **Uploader**: ein Schlüssel für ShareX, curl oder ein Skript, der Dateien in einen Ordner legt und jede mit einem Link beantwortet. **Meine Freigaben** listet jeden Link auf, den Sie erstellt haben, zum Kopieren oder Widerrufen. - Teilen Sie einen Ordner mit einer Person oder einer Gruppe, und er erscheint bei ihnen unter **Mit mir geteilt**. Dafür muss beim Speicher die **Zugriffskontrolle pro Element (RBAC)** eingeschaltet sein, was sie standardmäßig nicht ist. - Löschungen sind innerhalb einer Aufbewahrungsdauer umkehrbar, und Schreibvorgänge hinterlassen Snapshots, beides in dem Speicher, den Sie bereits eingebunden haben. - Ende-zu-Ende-verschlüsselte Ordner: im Browser verschlüsselt, und der Server erhält nie einen Schlüssel. Eine App, die Sie zulassen, bearbeitet eine solche Datei in Ihrem Browser, der sie für die App entschlüsselt und verschlüsselt, was sie speichert. Optionaler ClamAV-Scan jeder geschriebenen Datei. Alle Funktionen zu Freigaben und Schutz im Detail: [docs/FEATURES.md → Sharing and protection](docs/FEATURES.md#sharing-and-protection).

Ein öffentlicher Freigabelink, wie ihn der Empfänger sieht

Screenshots zu Freigaben und Schutz - der Dialog „Teilen“, was der Empfänger sieht, Meine Freigaben, wer verschlüsseln darf
![Der Dialog „Teilen“](https://filex.sh/shots/share-modal.d6cc52c97dae.png) Freigaben - PIN, Ablaufdatum, Download-Limit, `curl`-Einzeiler ![Markdown-Vorschau](https://filex.sh/shots/viewer-markdown.1789ecdcfbc5.png) Markdown-Vorschau
![Ein öffentlicher Freigabelink, wie ihn der Empfänger sieht](https://filex.sh/shots/public-share.0e3ba07f7c88.png) …und was die Person am anderen Ende öffnet. filex hat EINEN Bildschirm nach außen - eine geteilte Datei, ein Ordner, eine Dateianforderung, die Unterschriftsseite einer App und die PIN vor jedem davon sind alle diese Seite, im Namen Ihrer Instanz ![Meine Freigaben, das Menü „Aktionen“ einer Zeile geöffnet](https://filex.sh/shots/signing/my-shares-1440.6f8676cbb555.png) Meine Freigaben - die Links, die Sie erstellt haben, und deren PINs, wenn Sie eine weitergeben müssen
![Admin → Freigaben, das Menü „Aktionen“ einer Zeile geöffnet](https://filex.sh/shots/signing/admin-table-actions-1440.043e68a53922.png) Jede Tabelle im Adminbereich - ein angeheftetes Menü **Aktionen** pro Zeile, dasselbe Menü, das sich über das ⋮ des Explorers öffnet ![Admin → Verschlüsselung: die Genehmigungsrichtlinie und drei wartende Anfragen](https://filex.sh/shots/encryption/admin-encryption-1440.35606d99b816.png) Wer verschlüsseln darf - aus, nur Administratoren, alle, deren Rolle es erlaubt, oder nach Genehmigung durch einen Administrator; die wartenden Anfragen, jeweils mit der Angabe, wer gefragt hat und warum ([wer verschlüsseln darf](docs/E2E-ENCRYPTION.md#who-may-encrypt))
![Die Anfrage nach einem verschlüsselten Ordner, mit Begründung](https://filex.sh/shots/encryption/request-new-folder.e74894fba30f.png) …und aus Sicht der Person: die Anfrage, die der Dialog „Neuer Ordner“ öffnet - ein einzelner neuer verschlüsselter Ordner, bei einem Administrator mit Begründung angefragt

## Personen und Zugriff **Die Konten, die Ihre Leute schon haben, und für jeden genau eine Rolle.** - Anmeldung mit einem lokalen Passwort, OIDC, LDAP / Active Directory, einem authentifizierenden Proxy oder dem Windows- oder Linux-Konto des Rechners, auf dem filex läuft. - Jeder hat genau eine Rolle - Administrator, Benutzer, Betrachter oder eine eigene -, aufgebaut aus benannten Berechtigungen. Gruppen bringen Ordnerzugriff und eine Rolle mit, können den Gruppen Ihres Verzeichnisses folgen, und Ausnahmen pro Person gehen der Rolle vor. - Passwörter zu erraten dauert lange: Falsche Passwörter werden pro Konto und pro Adresse gezählt, im Webformular ebenso wie bei WebDAV, FTPS und SFTP; eine Bot-Prüfung (Cloudflare Turnstile oder reCAPTCHA) kann die Anmeldung, die PIN eines Links und den Upload in eine Dateianfrage schützen. - Von Grund auf mandantenfähig, hinter einem einzigen Schalter: Jeder Mandant hat eigene Anmeldeanbieter, eine eigene Domain und ein eigenes Zertifikat und verwaltet sich selbst. Ausgeschaltet zeigt keine Seite einen Mandanten. Alle Funktionen zu Personen und Zugriff im Detail: [docs/FEATURES.md → People and access](docs/FEATURES.md#people-and-access).

Admin → Rollen: die integrierten Rollen und zwei benutzerdefinierte

Screenshots zu Personen und Zugriff - Rollen, Gruppen, Anmeldesicherheit, ein gesperrtes Konto, Bot-Schutz, der Adminbereich und sein Menü
![Admin → Rollen: die integrierten Rollen und zwei benutzerdefinierte](https://filex.sh/shots/roles/roles-list-1440.6bb0779b66e3.png) Rollen - Administrator, Benutzer, Betrachter und eigene Rollen: wer sie jeweils hat, was sie erlauben, wo sie je nach Ordner abweichen, ihre Einschränkungen ([docs/PERMISSIONS.md](docs/PERMISSIONS.md)) ![Admin → Gruppen](https://filex.sh/shots/groups/groups-list-1440.22ff57b029f5.png) Gruppen - benannte Mengen von Personen mit Ordnerzugriff und einer Rolle; Mitglieder von Hand oder im Gleichschritt mit den Gruppen, die eine Anmeldung mitbringt ([docs/GROUPS.md](docs/GROUPS.md))
![Einen Ordner mit einer Gruppe teilen](https://filex.sh/shots/groups/share-group-1440.31c2a81e1eeb.png) Einen Ordner mit einer Gruppe teilen, neben Personen - „Eigentümer“ wird im Dialog erst nach Rückfrage erteilt, nicht per Klick ![Admin → Anmeldesicherheit](https://filex.sh/shots/loginsecurity/login-security-1440.70f2a2a76257.png) Anmeldesicherheit - die Begrenzung der Anmeldeversuche und die erlaubten Adressen, die nie mitgezählt werden; vertrauenswürdige Proxys, die Sperren und das Anmeldeprotokoll folgen auf derselben Seite ([Begrenzung der Anmeldeversuche](docs/CONFIGURATION.md#sign-in-attempt-limits))
![Das Anmeldeformular bei einem gesperrten Konto](https://filex.sh/shots/loginsecurity/login-locked-1440.4c65585bf49a.png) …und was das Anmeldeformular eines gesperrten Kontos sagt, während es die Sperre auf seiner Schaltfläche herunterzählt ![Übersicht im Adminbereich](https://filex.sh/shots/admin-dashboard.3becd8ffe998.png) Adminbereich
![Admin → Bot-Schutz, im dunklen Design](https://filex.sh/shots/botprotection/bot-protection-dark-1440.0aaf54749fc8.png) Bot-Schutz - Cloudflare Turnstile oder Google reCAPTCHA, die Schlüssel und die Formulare, die er schützt; ist der Anbieter nicht erreichbar, rechnet der Browser stattdessen kurz einen Proof of Work ([docs/BOT-PROTECTION.md](docs/BOT-PROTECTION.md)) ![Das Anmeldeformular mit der Bot-Prüfung über der Schaltfläche](https://filex.sh/shots/botprotection/login-captcha-dark-1440.77aef295650a.png) …und das Anmeldeformular mit der Bot-Prüfung über der Schaltfläche
![Startseite der Demo](https://filex.sh/shots/demo-landing.e484d8ad6b07.png) Startseite der Demo ![Der Bereich „Einstellungen“ des Adminmenüs, geöffnet über der Seite Admin → Einstellungen → Allgemein](https://filex.sh/shots/megamenu/settings-panel-1440.e51582dc1f4f.png) Das Adminmenü - alle Seiten in vier Bereichen, **Dateien & Speicher**, **Personen**, **Einstellungen** (Allgemein, Sicherheit & Daten, Dateiverarbeitung & Integrationen) und **Wartung & Protokolle**, mit einer kurzen Zeile unter jeder Seite; ein Smartphone bekommt dieselben Seiten in einer ausfahrbaren Leiste ([docs/ADMIN-PANEL.md](docs/ADMIN-PANEL.md))

## Desktop-App & CLI **Ordner auf Ihrem Computer bleiben live auf demselben Stand wie der Server.** - Eine App für Windows, Linux und macOS (Apple Silicon): derselbe Explorer in einem Fenster, mit mehreren Konten oder Mandanten nebeneinander. - Rechtsklick auf einen Ordner → **Auf diesem Computer behalten**, und er bleibt in beiden Richtungen auf demselben Stand wie der Server, in etwa einer Sekunde. Alles andere bleibt im Fenster nur online. - Sie meldet sich über Ihren Browser an, sodass sich SSO und MFA wie im Web verhalten, und sie öffnet Office-Dokumente von Ihrer eigenen Festplatte in dem Editor, den Ihr Server betreibt. - Headless-Rechner bekommen dieselbe Engine: `filex sync` und `filex client`. **Installieren Sie sie** aus dem Microsoft Store (Windows 10/11) oder dem Snap Store (Ubuntu und andere Linux-Systeme mit snapd):

Aus dem Microsoft Store herunterladen    Im Snap Store erhältlich

oder mit einem Paketmanager: ```bash brew install brf-tech/filex/filex-app # macOS 13+ (Apple Silicon), Homebrew tap BRF-Tech/homebrew-filex sudo snap install filex-app # the same snap as the badge above ```
Mehr zur Installation und zur CLI - der Store-Build, winget, die Release-Downloads, Linux, arm64, die Client-Befehle Der Store-Build (*filex File Manager*) ist die einzige Windows-Variante, die signiert ist - Microsoft signiert sie -, und der Store hält sie aktuell. Das winget-Paket der Desktop-App (`BRFTech.filex-app`) wartet auf seine erste Prüfung durch die winget-Moderatoren - bis es angenommen ist, lässt ein Release die Einreichung unverändert - sodass `winget install BRFTech.filex-app` das Paket noch nicht findet. Installer, portable `.exe`, AppImage, `.deb`, `.rpm` und `.dmg` sind dem [neuesten Release](https://github.com/BRF-Tech/filex/releases/latest) angehängt - noch nicht signiert, rechnen Sie also beim Windows-Installer mit einer SmartScreen-Meldung. Details: [docs/DESKTOP.md](docs/DESKTOP.md). Die CLI allein: `brew install brf-tech/filex/filex`, unter Windows `winget install BRFTech.filex` ([docs/CLI.md](docs/CLI.md)). Unter Linux brauchen `.deb` und `.rpm` nichts; ab Ubuntu 23.10 braucht ein AppImage einmalig ein AppArmor-Profil ([AppImage on recent Ubuntu](docs/DESKTOP.md#appimage-on-recent-ubuntu)), und das Snap läuft innerhalb der strikten Snap-Isolierung ([The snap and the sandbox](docs/DESKTOP.md#the-snap-and-the-sandbox)). Jedes Release baut auch für arm64: den Server, die Images und die Desktop-App unter Linux, Windows on Arm und Apple Silicon ([docs/INSTALLATION.md → ARM (arm64)](docs/INSTALLATION.md#arm-arm64)). Alles, was die App kann: [docs/FEATURES.md → Desktop app, phone and CLI](docs/FEATURES.md#desktop-app-phone-and-cli). Dieselbe Binärdatei ist auch ein Client für Server, Skripte und Headless-Rechner: ```bash filex client login --url https://files.example.com filex client upload build/report.pdf docs://ci-artifacts/ filex client mv docs://ci-artifacts/report.pdf archive://2026/ # across storages, waits for the job filex client run convert convert docs://data/table.csv --param target=xlsx filex sync add ~/Documents/work docs://work # the engine the desktop app uses filex sync run --watch 30s ``` Siehe [docs/CLI.md](docs/CLI.md) und [docs/SYNC.md](docs/SYNC.md).

## In Ihre Anwendung einbetten **Ein echter Dateimanager in Ihrem eigenen Produkt.** Dieselbe Oberfläche gibt es als Vue-3-Komponente, als React-Komponente und als frameworkunabhängige Webkomponente ``, mit Ihrem eigenen filex-Server dahinter. Ein beschränkter API-Schlüssel bindet sie an einen Ordner pro Mandant, und das setzt das Backend durch, nicht das Widget. Die Webkomponente braucht zwei Zeilen: ```html ```

Eingebettete Webkomponente

Vue 3 und React - die beiden anderen Wrapper und wo die Details stehen ### Vue 3 ```bash pnpm add @brftech/filex-core ``` ```vue ``` ### React ```bash pnpm add @brftech/filex-react ``` ```jsx import { FileManager } from '@brftech/filex-react'; console.error(e)} /> ``` Stylesheets, Bundler, die Attribute `sidenav` / `connections` / `ui-profile`, beschränkte API-Schlüssel für mandantenfähige Host-Anwendungen, ein Sitzungs-Cookie von einem anderen Ursprung (Origin) und das Drucken aus einer App: [docs/INTEGRATION.md](docs/INTEGRATION.md), zusammengefasst in [docs/FEATURES.md → Embedding](docs/FEATURES.md#embedding). ⚠ Halten Sie Pakete und Server auf derselben Version ([docs/API.md](docs/API.md)).
![Mit mir geteilt](https://filex.sh/shots/sidenav/view-shared-1440.faf6f6668c20.png) Mit mir geteilt - Ordner, für die Ihnen andere Zugriff erteilt haben, keine Anleitung zum Einbinden ![Eingebettete Webkomponente](https://filex.sh/shots/sidenav/embed-webcomponent-1440.b802d5b6ab56.png) Eingebettet in die Seite eines anderen Produkts

## Apps **Neue Möglichkeiten mit Dateien, mit genau den Berechtigungen, die Sie genehmigt haben.** Eine App ist ein WebAssembly-Modul, das in filex in einer Sandbox läuft, eine eigene Oberfläche in einem Sandbox-Frame oder beides. Sie installieren sie über den Link eines Stores oder über ihre GitHub-Adresse, lesen jede Berechtigung, die sie verlangt, und nichts aktualisiert sich von selbst. Die Personen Ihres filex können auf der Seite **App-Store** einen vertrauenswürdigen Store durchsuchen und Sie um eine App oder ein Speicher-Plug-in bitten. Fünf gibt es als öffentliche Repositorys: | App | Was sie hinzufügt | |---|---| | [E-Signatur](https://github.com/BRF-Tech/filex-sign) | Ein PDF unterschreiben oder andere darum bitten: Personen auf diesem filex unterschreiben darin, alle anderen über einen privaten Link, standardmäßig hinter einer PIN | | [Konvertieren](https://github.com/BRF-Tech/filex-convert) | **Konvertieren…** für jede Datei oder Auswahl: Bilder, Video, Audio, Dokumente, E-Books, Archive, Daten, Untertitel und Schriftarten | | [Office editor](https://github.com/BRF-Tech/filex-office-editor) | Word-, Excel- und PowerPoint-Dokumente im Editor von ONLYOFFICE, im Browser und ohne Document Server; seine für filex 0.56 gebauten Versionen 0.2.0 und 0.3.0 bringen verschlüsselte Ordner und mehrere Personen gleichzeitig dazu |; Version 0.4.0, für filex 0.57 gebaut, öffnet jede Art, die ein Document Server öffnet (`.doc`, `.xls`, `.ppt`, `.csv`...), und bringt eine Office-Engine mit, die filex auf dem Server für Office-Vorschaubilder und -Konvertierungen ausführt ([docs/OFFICE-EDITOR.md](docs/OFFICE-EDITOR.md)) | [filextext](https://github.com/BRF-Tech/filextext-app) | Ein Ende-zu-Ende-verschlüsselter Text-Arbeitsbereich in einer einzigen `.fxtxt`-Datei | | [draw.io](https://github.com/BRF-Tech/filex-drawio) | Der Diagrammeditor draw.io, für `.drawio`- und `.dio`-Dateien | Eine App, die Sie zulassen, kann eine Datei **gemeinsam** mit anderen bearbeiten - das Relay von filex bringt ihre Änderungen in eine Reihenfolge, ohne sie zu lesen, und wer nur lesen darf, sieht live zu - und eine Datei eines **verschlüsselten Ordners** öffnen, die Ihr Browser für sie entschlüsselt und vor dem Speichern wieder verschlüsselt. Eine App kann außerdem verlangen, vor dem ersten Lauf einmal eingerichtet zu werden - ihre eigenen Fragen, die Adressen, unter denen sie antwortet, wer sie benutzen darf -, einen kleinen eigenen Datenspeicher neben der Datenbank von filex führen und eigene öffentliche Adressen beantworten. Eine App mit der Rolle **Link-Kürzer** macht Links kurz: **Kurzlink holen** im Freigabedialog, bei Dateianforderungen, in Meine Freigaben und bei jedem Upload eines Uploaders ([docs/APP-PLUGINS.md → Short links](docs/APP-PLUGINS.md#short-links), [für App-Autoren](docs/APP-PLUGINS-API.md#public-routes-060)). Auch ein Sprachpaket ist eine App: Spanisch, Deutsch und Französisch gibt es als Beispiele. In wenigen Minuten eine installieren: [docs/APP-PLUGINS.md → Install one](docs/APP-PLUGINS.md#install-one). Alle Funktionen der Apps im Detail: [docs/FEATURES.md → Apps](docs/FEATURES.md#apps).

Die Felder auf dem Dokument platzieren

Screenshots der Apps - eine Unterschriftsanfrage von Anfang bis Ende, eine App installieren, der Konverter, eine App mit eigener Oberfläche, gemeinsames Bearbeiten, die Datei eines verschlüsselten Ordners in einer App, ein Sprachpaket, Standard-Apps, Installation aus einem Store Dana bittet einen Kollegen auf demselben filex und einen Partner außerhalb davon, eine Vereinbarung zu unterschreiben. Die App ist [E-Signatur](https://github.com/BRF-Tech/filex-sign); jeden Bildschirm zeichnet filex, und der Link, den der Partner bekommt, ist eine gewöhnliche Freigabe.
![Die Felder einer Unterschriftsanfrage festlegen](https://filex.sh/shots/signing/sign-define-1440.63ea72b13724.png) Legen Sie die Felder fest - benennen Sie jedes und geben Sie an, wem es gehört; das Dokument kommt als Nächstes ![Die Felder auf dem Dokument platzieren](https://filex.sh/shots/signing/sign-place-1440.696a10b65be8.png) Platzieren Sie sie - wählen Sie ein Feld, tippen Sie dort auf die Seite, wo es hingehört
![Die PIN-Abfrage des externen Unterzeichners](https://filex.sh/shots/signing/sign-outside-pin-1440.2cd8ccb99483.png) Der Link des Partners - der eine öffentliche Bildschirm von filex, im Namen Ihrer Instanz, hinter einer PIN ![Der externe Unterzeichner füllt seine Felder aus](https://filex.sh/shots/signing/sign-outside-fill-1440.9f50aeb7abef.png) …und was sich dahinter öffnet: nur die eigenen Felder - hier ein Name, getippt in der Schrift, die die anfordernde Person gewählt hat (gezeichnet und hochgeladen sind die beiden anderen)
![Das gesperrte Dokument mit geöffnetem Bereich „Unterschriften“](https://filex.sh/shots/signing/sign-status-1440.eb318cc10a90.png) Solange es im Umlauf ist - das Dokument ist für alle eingefroren, in seinen Details steht, wer unterschrieben hat ![Die Berechtigungsprüfung des Installationsassistenten](https://filex.sh/shots/apps/apps-install-review-1440.cdb1a4ebf8f6.png) Eine App installieren - jede Berechtigung, die sie verlangt, in klaren Worten, bevor irgendetwas läuft
![Die Detailansicht einer installierten App](https://filex.sh/shots/apps/apps-detail-1440.b7f6ec845458.png) Eine installierte App - woher sie stammt, ihr Fingerabdruck und jede Berechtigung, die sie hat, in klaren Worten (ihre Einstellungen und ihre Aktionen folgen weiter unten auf der Seite) ![Der Assistent des Konverters](https://filex.sh/shots/apps/convert-wizard-1440.231ada006fd6.png) Der Konverter, eine weitere App - jedes Ziel unter seiner Kategorie, drei Schritte
![Die Prüfung bei der Installation einer App mit eigener Oberfläche](https://filex.sh/shots/apps/app-interface-review-1440.877a89c82359.png) Eine App, die ihre eigene Oberfläche mitbringt - die Prüfung zeigt den Fingerabdruck des Pakets, jede Adresse außerhalb davon (eine Live-Adresse ist eine Berechtigung, in Gelb) und was ein Browser nicht versprechen kann ![Die eigene Oberfläche einer App, als Vorschau einer Datei geöffnet](https://filex.sh/shots/apps/app-interface-viewer-1440.519b23618156.png) …und diese Oberfläche, mit ihrem eigenen Dateityp geöffnet, dort, wo sonst die Vorschau von filex wäre. Sie liest und speichert die Datei über filex, in einem Sandbox-Frame (eine kleine Beispiel-App, für diese Bilder geschrieben)
![Zwei Personen in einem Dokument: eine bearbeitet, die andere sieht zu](https://filex.sh/shots/officeapp/coedit-watcher-1280.904b31e20f36.png) Gemeinsam bearbeiten - Dana tippt, und Sam, der nur lesen darf, sieht jede Änderung und ihren Cursor über das Relay von filex ankommen ([Gemeinsam bearbeiten](docs/APP-PLUGINS-API.md#editing-together-coedit-056); eine Beispiel-App, für diese Bilder geschrieben) ![Eine Datei eines verschlüsselten Ordners, in einer App geöffnet, vom Browser entschlüsselt](https://filex.sh/shots/e2eapp/app-encrypted-folder-1280.856d3586a9e2.png) Eine Datei eines Ende-zu-Ende-verschlüsselten Ordners in einer App, die Sie zugelassen haben - Ihr Browser entschlüsselt sie für die App und verschlüsselt, was gespeichert wird, und der Server hält weiterhin nur Chiffretext (dieselbe Beispiel-App; [In einer App bearbeiten](docs/E2E-ENCRYPTION.md#editing-in-an-app))
![Die Liste „Apps“, ein Sprachpaket unter den Apps](https://filex.sh/shots/langpack/apps-list-1440.004f0c819981.png) Jede App auf der Instanz, darunter ein **Sprachpaket** - ein Manifest, in dem nichts läuft: Es sagt, wie viel von diesem filex es übersetzt, und mit ihm geht seine Sprache wieder ![Plug-ins → Standard-Apps](https://filex.sh/shots/defaultapps/default-apps-1440.0dd62b519f8f.png) Standard-Apps - jeder Dateityp, den außer filex noch etwas verarbeitet: wer ihn öffnet und wer sein Vorschaubild erzeugt, in der Reihenfolge, die Sie festlegen ([Standard-Apps](docs/APP-PLUGINS.md#default-apps-which-app-opens-a-file-and-which-draws-its-thumbnail))
![Ordner, gezeichnet mit ihren neuesten Dateien](https://filex.sh/shots/thumbnails/folders-grid-1440.dd7653d6edca.png) Ordnervorschauen - jeder Ordner, gezeichnet mit den drei Dateien, die zuletzt hineingekommen sind; die SVGs zeichnet die integrierte Engine von filex ([docs/thumbnails.md](docs/thumbnails.md#folder-previews)) ![Die Installationsprüfung, geöffnet über den Link eines Stores](https://filex.sh/shots/store/store-review-1440.3f717d71fb42.png) Installation aus einem Store - dieselbe Prüfung, markiert mit **Aus dem Store …**; der Lizenzschlüssel der kostenpflichtigen App ist nur an seinen ersten Zeichen zu sehen ([Installation aus einem Store](docs/APP-PLUGINS.md#installing-from-a-store))
![Der erste Link von einem Store: vertrauen?](https://filex.sh/shots/store/store-trust-1440.8fb07862db1a.png) Der erste Link von einem Store - seine Adresse und die Fingerabdrücke seiner Schlüssel, zum Vergleichen, bevor Sie ihm vertrauen ([Vertrauenswürdige Stores](docs/APP-PLUGINS.md#trusted-stores)) ![Eine angehaltene kostenpflichtige App, das Hinweisband auf einer Seite des Adminbereichs](https://filex.sh/shots/store/store-license-held-1440.6fd145640e0f.png) Eine Lizenz, die der Store widerrufen hat - die App angehalten, *Nicht lizenziert*, nichts entfernt, und ein Hinweisband auf jeder Seite des Adminbereichs ([Kostenpflichtige Apps](docs/APP-PLUGINS.md#paid-apps))

## KI-Agenten / MCP **Ein Agent arbeitet in dem Ordner, den Sie ihm gegeben haben, und nirgendwo sonst.** - Ein nativer **MCP-Server** unter `/api/ai/mcp` und eine REST-Schnittstelle unter `/api/ai`, beschrieben in einer OpenAPI-3.1-Datei. - Ein API-Schlüssel trägt Berechtigungen pro Verb und kann auf einen einzigen Ordner beschränkt werden, und nichts, was er ausgibt, kann weiter reichen als der Schlüssel selbst. - Eine große Datei geht über ein **Upload-Ticket**: eine kurzlebige, nur einmal verwendbare URL, sodass ihre Bytes nie durch den Kontext des Modells wandern. ```bash claude mcp add filex --transport http https://files.example.com/api/ai/mcp \ --header "Authorization: Bearer " ``` Was ein Agent tun kann, was ein Schlüssel nie ausgeben kann, verschlüsselte Ordner und Upload-Tickets: [docs/FEATURES.md → AI agents and MCP](docs/FEATURES.md#ai-agents-and-mcp); die Referenz ist [docs/MCP.md](docs/MCP.md).
# Umstieg von Nextcloud, Dropbox oder Google Drive filex ist ein Dateimanager, keine Groupware-Suite. Was das neben vier Dingen bedeutet, von denen Sie vielleicht kommen (File Browser ist eines davon): | Sie kommen von | Mit filex | |---|---| | **Nextcloud**
Eine Plattform für die Zusammenarbeit, die Sie selbst betreiben oder von einem Anbieter beziehen: Dateien und rundherum Kalender, Kontakte, E-Mail, Chat, Videoanrufe und ein Online-Office. Eine PHP-Anwendung hinter einem Webserver, mit einer Datenbank. | Nur der Dateiteil.
Eine einzige Go-Binärdatei mit SQLite darin (PostgreSQL oder MySQL, wenn Sie wollen).
Eine Desktop-App mit Live-Ordner-Sync, Freigabelinks, SSO und LDAP.
Office-Dokumente, allein oder gemeinsam, in der Office-Editor-App oder in dem ONLYOFFICE, das Sie anbinden.
Kein Kalender, keine Kontakte, keine E-Mail, kein Chat, keine Videoanrufe. | | **Dropbox**, **Google Drive**
Gehostete Dienste: Ihre Dateien liegen auf den Servern des Anbieters, unter seinem Kontingent und seinen Bedingungen. | Ihr eigener Server und der Speicher, den Sie schon haben: eine Festplatte, eine NAS-Freigabe, ein S3-Bucket.
Das Alltägliche ist da: eine Weboberfläche, Freigabelinks mit PIN und Ablaufdatum, Dateianforderungen, Papierkorb und Versionsverlauf.
Eine Desktop-App, die die Ordner, die Sie wählen, auf demselben Stand hält. | | **File Browser**
Eine einzige Binärdatei, die eine Weboberfläche über ein Verzeichnis legt, auf das Sie sie richten, mit Benutzerkonten (jeweils mit eigenem Bereich und eigenen Berechtigungsschaltern), Erlaubnis- und Sperrregeln pro Pfad und Freigabelinks mit Passwort und Ablaufdatum. Sein Repository ist archiviert, und seine [README](https://github.com/filebrowser/filebrowser) sagt, dass es keine weiteren Releases, Fehlerbehebungen oder Sicherheitskorrekturen geben wird. | Derselbe Start mit einem einzigen Befehl.
Mehrere Speicher nebeneinander.
Rollen und Gruppen über dem Zugriff pro Ordner; OIDC-Single-Sign-on und LDAP eingebaut.
Papierkorb und Versionen, Volltextsuche.
Derselbe Baum, erreichbar als S3, SFTP, FTPS, NFSv3 und WebDAV. | **Was filex nicht hat**, egal, woher Sie kommen: - **Eine Android- oder iOS-App.** Auf dem Smartphone ist filex die Web-App, die sich wie eine App installieren lässt ([Auf einem Smartphone oder Tablet](docs/DESKTOP.md#on-a-phone-or-a-tablet-the-web-app)), aber eine Verbindung braucht, um Dateien anzuzeigen; ist sie geschlossen, kommen Benachrichtigungen als Web Push, sobald Sie das für das Gerät einschalten. - **Platzhalterdateien im Finder oder Explorer.** Die Desktop-App kopiert die Ordner, die Sie auf dem Computer behalten, und alles andere bleibt in ihrem eigenen Fenster online ([docs/DESKTOP.md](docs/DESKTOP.md#keeping-folders-on-this-computer)). - **Einen in die Binärdatei eingebauten Office-Editor.** Office-Dokumente werden - allein oder gemeinsam - in der Office-Editor-App bearbeitet, die Sie installieren ([`filex-office-editor`](https://github.com/BRF-Tech/filex-office-editor), der Editor von ONLYOFFICE im Browser, ohne Document Server), oder in einem ONLYOFFICE Document Server, den Sie anbinden; ohne beides öffnen sie sich in einer schreibgeschützten Vorschau ([docs/ONLYOFFICE.md](docs/ONLYOFFICE.md)).
Der Umzug - was mitkommt und was nicht - Wo die Dateien schon an einem Ort liegen, den filex einbinden kann - ein Ordner auf einer Festplatte oder einer NAS-Freigabe, ein Präfix in einem S3-Bucket, ein SFTP-, FTP- oder WebDAV-Server -, ist der Umzug ein Einbinden, keine Migration. filex speichert Dateien nicht selbst: Richten Sie einen Speicher auf diesen Ordner, und die Dateien sind da, so wie sie sind. - Dateien in Dropbox oder Google Drive müssen zuerst an einen solchen Ort kopiert werden: filex bringt für keinen der beiden einen Speichertreiber mit. - Nur die Dateien ziehen um: Die Links, Berechtigungen und der Versionsverlauf, die das alte System hatte, werden nicht importiert. - Was filex hinzufügt - Papierkorb, Versionsverlauf, Entwürfe -, liegt in versteckten Ordnern im Wurzelverzeichnis des Speichers, und ein Ordner, den Sie Ende-zu-Ende verschlüsseln, enthält von da an Geheimtext ([docs/STORAGE.md](docs/STORAGE.md), [docs/TRASH-VERSIONING.md](docs/TRASH-VERSIONING.md)).

# Selbst hosten mit Compose oder Helm Das `docker run` oben genügt, um filex auszuprobieren. Für eine produktive Installation liegen fertige Stacks in [`deploy/`](deploy/): - **[`deploy/compose/`](deploy/compose/)** - Docker Compose: - **minimal** - filex + SQLite + lokaler Datenträger (ein Dienst, null Abhängigkeiten). - **full** - filex + PostgreSQL + Redis + Caddy (automatisches HTTPS) sowie zuschaltbare Add-ons: **ONLYOFFICE**, **Drawio** und ein **S3-Server** (Versity S3 Gateway). Schalten Sie jedes mit einem Compose-Profil in `.env` ein oder aus. Die Konvertierung übernimmt die [App „Konvertieren“](#apps), kein Sidecar. - **[`deploy/helm/filex/`](deploy/helm/filex/)** - ein Helm-Chart für Kubernetes (Deployment + PVC + optionaler Ingress), mit jedem Release veröffentlicht: `helm repo add brf-tech https://helm.brf.sh`, dann `helm install filex brf-tech/filex` (oder `oci://ghcr.io/brf-tech/charts/filex`). Jedes der oben genannten Add-ons ist ein `enabled`-Schalter in `values.yaml` - installieren Sie PostgreSQL / Redis / einen S3-Server mit, oder binden Sie ein externes ONLYOFFICE / Drawio an. Schritt-für-Schritt-Anleitungen für jede Ausbaustufe stehen in [docs/INSTALLATION.md](docs/INSTALLATION.md). filex läuft im Wurzelpfad eines eigenen Hosts oder unter einem Pfad eines gemeinsam genutzten Hosts (`https://example.com/filex/`): eine Einstellung, `FILEX_BASE_PATH`, und ein Proxy, der den vollständigen Pfad weitergibt - Beispiele für Caddy, nginx und Helm in [docs/DEPLOYMENT.md → Serving filex under a sub-path](docs/DEPLOYMENT.md#serving-filex-under-a-sub-path).
# Dokumentation Die Anleitungen sind als Website unter [docs.filex.sh](https://docs.filex.sh) veröffentlicht, und das [vollständige Dokumentationsverzeichnis](docs/README.md) führt jede Seite auf. Beginnen Sie mit [Installation](docs/INSTALLATION.md), [Konfiguration](docs/CONFIGURATION.md), der [Desktop-App](docs/DESKTOP.md), den [Protokollen](docs/PROTOCOLS.md), den [Apps](docs/APP-PLUGINS.md) und [ONLYOFFICE](docs/ONLYOFFICE.md). [Funktionen](docs/FEATURES.md) gibt jeder Funktion einen Eintrag mit ihren Grenzen und ihrer Anleitung.
# Funktionen | Bereich | Was Sie bekommen | |---|---| | **Der Explorer** | Ein einziges Layout im Adminbereich, in der Desktop-App und in jeder Einbettung: ein Navigationsbereich, Listen-, Raster- und Galerieansicht, Tabs, persönliche Tags und Team-Tags, eine ⌘K-Befehlspalette, neu belegbare Tastenkürzel, neue Dokumente aus dem Menü **+ Neu** und Designs, die ein Betreiber zusammenstellt ([Integration](docs/INTEGRATION.md), [Designs](docs/INTEGRATION.md#themes)) | | **Speicher** | Lokale Datenträger, S3, FTP, SFTP, WebDAV und SMB/NAS nebeneinander eingebunden, Kopieren und Verschieben zwischen ihnen und ein Plug-in für alles andere, aus dem Adminbereich oder aus einem App-Store; ein kleiner Agent, filex-watch, auf dem Rechner, dem eine über das Netz erreichte Festplatte gehört, damit Änderungen dort sofort erscheinen ([Speicher](docs/STORAGE.md), [Speicher-Plug-ins](docs/PLUGINS.md), [filex-watch](docs/FILEX-WATCH.md)) | | **Ohne Browser** | Derselbe Baum, bereitgestellt als S3, SFTP, FTPS, NFSv3 und WebDAV - ein Verschieben oder Löschen dort ist neben einem Speicher-Scan so sicher wie eines in der Weboberfläche -, dazu `filex mount` über HTTPS ([Protokolle](docs/PROTOCOLS.md)) | | **Anmeldung** | OIDC, LDAP / Active Directory, Windows- und Linux-Konten, die Begrenzung der Anmeldeversuche und eine Bot-Prüfung bei der Anmeldung und den öffentlichen Formularen - Turnstile oder reCAPTCHA, mit einem lokalen Proof of Work, wenn der Anbieter nicht erreichbar ist ([SSO](docs/SSO.md), [LDAP](docs/LDAP.md), [Betriebssystemkonten](docs/OS-LOGIN.md), [Bot-Schutz](docs/BOT-PROTECTION.md)) | | **Personen und Zugriff** | Rollen und Berechtigungen pro Person, Gruppen, Zugriff pro Ordner und native Mandantenfähigkeit ([Berechtigungen](docs/PERMISSIONS.md), [Gruppen](docs/GROUPS.md), [Mandantenfähigkeit](docs/MULTI-TENANCY.md)) | | **Freigaben** | Öffentliche Links mit PIN, Ablaufdatum und Download-Limit, Dateianforderungen und Einladungen zur Freigabe per E-Mail ([Freigaben](docs/SHARING.md)); Screenshot-Werkzeuge und Skripte, die hochladen und einen Link zurückbekommen ([Uploader](docs/UPLOADERS.md)); jede E-Mail und jede öffentliche Seite als bearbeitbare Vorlage ([Vorlagen](docs/TEMPLATES.md)) | | **Schutz** | Papierkorb und Versionsverlauf, optionaler ClamAV-Scan, Ende-zu-Ende-verschlüsselte Ordner, Replikation auf einen zweiten Speicher (mit einer ersten Kopie dessen, was schon da ist) und ein Audit-Protokoll ([Papierkorb & Versionierung](docs/TRASH-VERSIONING.md), [Schutz](docs/PROTECTION.md), [E2E-Verschlüsselung](docs/E2E-ENCRYPTION.md), [Replikation](docs/REPLICATION.md), [Audit-Protokoll](docs/BACKEND.md#admin-audit-log)) | | **Vorschauen und Editoren** | Bilder, Video, Audio, PDF, Markdown, Code (Monaco), Office-Dokumente in der Office-Editor-App oder über ONLYOFFICE, draw.io-Diagramme, Mermaid-Diagramme, gezeichnet und als Text bearbeitet, 3D-Modelle und Archive in ZIP, 7z und TAR ([ONLYOFFICE](docs/ONLYOFFICE.md), [Archive](docs/ARCHIVES.md)) | | **Suche und Vorschaubilder** | Eingebettete Volltextsuche, die Berechtigungen beachtet, und Vorschaubilder für Bilder, Video, PDF, Ordner und Office-Dokumente - die der Office-Dokumente zeichnet auf dem Server die Engine der Office-Editor-App oder ein angebundenes ONLYOFFICE ([Suche](docs/SEARCH.md), [Vorschaubilder](docs/thumbnails.md)) | | **Echtzeit** | Anwesenheit und Live-Aktualisierungen von Dateien über WebSocket, und gemeinsames Bearbeiten einer Datei in einer App, über das Relay von filex ([Echtzeit](docs/REALTIME.md), [Gemeinsam bearbeiten](docs/APP-PLUGINS-API.md#editing-together-coedit-056)) | | **Clients** | Eine Desktop-App mit Ordner-Sync, eine Web-App, die sich auf dem Smartphone unter dem Namen und dem Logo Ihrer Instanz installieren lässt, eine CLI, Einbettungen als Vue-, React- und Webkomponente, eine REST-API und ein MCP-Server ([Desktop](docs/DESKTOP.md), [Sync](docs/SYNC.md), [CLI](docs/CLI.md), [Integration](docs/INTEGRATION.md), [MCP](docs/MCP.md)) | | **Apps und Sprachen** | Apps in einer Sandbox (E-Signatur, Konvertieren, Office editor, filextext, draw.io), die über filex drucken, eine Datei über sein Relay gemeinsam bearbeiten und die Datei eines verschlüsselten Ordners nur öffnen, wenn Sie es zulassen, in Ihrem Browser entschlüsselt; Sprachpakete und ein Layout von rechts nach links ([Apps](docs/APP-PLUGINS.md), [In einer App bearbeiten](docs/E2E-ENCRYPTION.md#editing-in-an-app), [RTL](docs/RTL.md)) | | **Betrieb** | Eine Binärdatei oder ein Container; SQLite, PostgreSQL oder MySQL; ein Adminbereich mit einer einzigen Suche für jede Seite, jede Einstellung und jeden Datensatz; Webhooks, eine Glocke in der Anwendung und Web Push auf Smartphones und Browser, mit optionaler Zusammenfassung; eine Ansicht für Nutzung und Kosten (heute Backblaze B2); Update-Prüfungen, mit Patch-Releases, die sich selbst installieren, sobald Sie es erlauben ([Datenbanken](docs/DATABASES.md), [Adminbereich](docs/ADMIN-PANEL.md), [Benachrichtigungen](docs/NOTIFICATIONS.md), [Nutzung](docs/USAGE.md), [Updates](docs/UPDATES.md)) | Jede Funktion als eigener Eintrag - wie sie sich verhält, ihre Grenzen und die Seite, die sie beschreibt: [docs/FEATURES.md](docs/FEATURES.md).
# Architektur Siehe [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
Die Bausteine auf einen Blick - Treiber, Protokolle und Pakete in einem Diagramm ``` ┌─────────────────────────────────────────────────────────────┐ │ filex (Go binary; image ~62 MB slim / ~241 MB full) │ ├─────────────────────────────────────────────────────────────┤ │ HTTP API (chi) │ Admin UI (Vue 3, embedded) │ │ Auth Drivers: │ local · oidc · ldap · proxy-header │ │ │ pam · windows (OS accounts) │ │ Sign-in guard: │ attempt limits · IP allow-list · realms │ │ Storage Drivers:│ local · s3 · ftp · sftp · webdav · smb │ │ Served as: │ s3 · sftp · ftps · nfs · webdav │ │ DB Drivers: │ sqlite (default) · mysql · postgres │ │ Queue Drivers: │ follows the DB · redis │ │ Realtime: │ WebSocket presence + live updates │ │ RBAC: │ roles + groups + grants + share invites │ │ AI / MCP: │ /api/ai REST + native MCP server │ │ Sync Worker: │ etag / size+mtime diff + tombstone │ │ Replica Layer: │ primary→replica + rules + reconcile │ │ Protection: │ trash + versions + ClamAV (bin/clamd) │ │ E2E folders: │ client-side WebCrypto (server blind) │ │ Co-editing: │ sealed relay for apps · watchers │ │ Notifications: │ webhook + in-app bell + read/unread │ │ Search: │ Bleve (full-text, embedded) │ │ Thumbnails: │ image · svg · video · pdf · office │ │ │ heic · text · zip · folders · apps │ │ Plug & Play: │ OnlyOffice · Drawio · Mermaid │ │ Apps (wasm): │ sandboxed · e-Signature · Convert │ │ Languages: │ en · tr + language packs · RTL layout │ │ Appearance: │ operator themes · instance default │ └─────────────────────────────────────────────────────────────┘ ▲ │ HTTP API ┌──────────────────┼──────────────────┐ │ │ │ @brftech/ @brftech/ @brftech/ filex-core filex filex-react (Vue 3 SFC) (Web Component) (React adapter) │ │ │ ▼ ▼ ▼ Vue 3 apps Any framework React apps (vanilla, Angular, Svelte, Solid, …) Same API, no server plugins: desktop app (Electron, Windows/Linux/macOS) CLI client (filex client · filex sync) ```

# Wie filex entsteht filex hat einen einzigen Maintainer, der es mit KI-Coding-Agenten (Claude Code) baut. Der Maintainer entscheidet, was filex ist und wie es funktioniert: die Architektur, das Daten- und das Sicherheitsmodell und wie sich jede Funktion verhält. Die Agenten schreiben den größten Teil des Codes innerhalb dieser Vorgaben, in Sprachen, mit denen der Maintainer arbeitet. Etwa 82 % der Commits im Entwicklungsrepository tragen eine Zeile `Co-Authored-By: Claude`; verborgen wird das also nicht. Es ist KI-gestützt, aber kein ungeprüfter generierter Code: - Jede Änderung durchläuft die Testkette, bevor sie aufgenommen wird: Go-Tests (auch unter dem Race-Detector), etwa 500 Vitest-Dateien, etwa 120 Playwright-Spezifikationen unter Chromium, Firefox und WebKit, Cypress sowie Datenbanktests mit SQLite, PostgreSQL und MySQL. Jedes Release wird erst getaggt, nachdem die vollständige Testmatrix von GitHub und ein Probelauf des Release-Workflows auf genau diesem Commit bestanden haben. - Änderungen an Anmeldung, Berechtigungen, Freigaben und Verschlüsselung durchlaufen zusätzliche Prüfrunden, und ein roter Test wird repariert, nicht gelockert. - Sicherheitsmeldungen werden offen behandelt: siehe [SECURITY.md](SECURITY.md) und die veröffentlichten Sicherheitshinweise. Eine unabhängige Prüfung hat es noch nicht gegeben. - Die deutsche, spanische, französische und chinesische README sowie die deutschen, spanischen und französischen Sprachpakete sind maschinelle Übersetzungen, die noch kein Muttersprachler geprüft hat. # Mitwirken [![CI](https://img.shields.io/github/actions/workflow/status/BRF-Tech/filex/ci.yml?branch=main&label=ci)](https://github.com/BRF-Tech/filex/actions) Issues und Pull-Requests sind willkommen; öffnen Sie vor einem umfangreicheren Pull-Request ein Issue, das sagt, was Sie vorhaben. [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) beschreibt den Arbeitsablauf, die Tests, die eine Änderung bestehen muss, und die Regeln für die Dokumentation, und das Projekt folgt dem [Contributor Covenant](CODE_OF_CONDUCT.md). Ein Sicherheitsproblem wird vertraulich gemeldet, wie [SECURITY.md](SECURITY.md) es beschreibt. Was sich in jedem Release geändert hat, steht in [CHANGELOG.md](CHANGELOG.md). Jeden Tag um 10:00 Uhr Istanbuler Zeit wird aus dem, was `main` dann enthält, ein Release erstellt, sofern es etwas Neues enthält; ein Pull-Request, der nach diesem Schnitt gemergt wird, erscheint mit dem Release des nächsten Tages ([Release-Prozess](docs/CONTRIBUTING.md#release-process)).
Entwicklung - aus dem Quellcode bauen, und was wo liegt ```bash git clone https://github.com/BRF-Tech/filex.git cd filex pnpm install pnpm run build:all # builds packages, web, then Go binary ./bin/filex serve ``` Unterverzeichnisse: - `backend/` - Go-HTTP-Dienst (cmd/filex, internal/*, db/queries, db/migrations) - `packages/core` - `@brftech/filex-core` (Vue-3-SFC, maßgebliche Quelle) - `packages/webcomponent` - `@brftech/filex` (Webkomponenten-Wrapper) - `packages/react` - `@brftech/filex-react` (React-Adapter über @lit/react) - `web/` - Vue-3-Oberfläche des Adminbereichs (per `go:embed` in die Go-Binärdatei eingebettet) - `desktop/` - Electron-App (gebündelter Hauptprozess, Synchronisierung im Infobereich, automatische Updates) - `demo/` - eigenständige HTML-Demos für jedes Framework - `e2e/` - Playwright-Suiten (Web, Einbettungen, paketierte Desktop-App) + `shots/`, die Skripte, die `pnpm shots` ausführt, um die oben gezeigten Screenshots aufzunehmen (veröffentlicht auf filex.sh, nicht im Repository abgelegt) - `docker/` - Dockerfiles + compose - `deploy/` - fertige Compose-Stacks + Helm-Chart (siehe [`deploy/`](deploy/)) - `docs/` - Markdown-Dokumentation - `docs-site/` - VitePress-Website, veröffentlicht unter [docs.filex.sh](https://docs.filex.sh)

# Lizenz MIT - siehe [LICENSE](LICENSE). Die Store-Badges in [`docs/badges/`](docs/badges/) sind die eigenen Grafiken der Stores, werden unverändert verwendet und fallen nicht unter diese Lizenz: Microsoft und das Microsoft-Store-Badge sind Marken der Microsoft-Unternehmensgruppe; das Snap-Store-Badge ist © Canonical Ltd., lizenziert unter [CC BY-ND 2.0 UK](https://creativecommons.org/licenses/by-nd/2.0/uk/). Nextcloud, Dropbox, Google Drive, File Browser und ONLYOFFICE sind Namen von Produkten anderer Anbieter und werden hier nur verwendet, um diese zu beschreiben. filex ist mit keinem davon verbunden und wird von keinem davon gesponsert oder empfohlen.