MoeShare nimmt Bilder, Videos, Audio, Texte und beliebige Dateien von ShareX, aus dem Browser oder per Link entgegen und macht daraus Links mit schöner Vorschau, auch in Discord. Dazu kürzt es lange Adressen und sammelt Dateien in Alben, die du auch mit anderen Konten teilen kannst. Jede Person gestaltet ihre Vorschauseiten selbst und kann eine eigene Domain verbinden. Eingerichtet wird alles im Browser: Beim ersten Start führt dich ein Assistent durch Datenbank, Admin-Konto und Einstellungen, eine .env brauchst du nicht. Wer von Zipline, XBackBone oder Chibisafe kommt, nimmt Konten, Dateien und alte Links mit.
Mehr zum Projekt, Screenshots und eine Kurzanleitung gibt es auf moeshare.moestudio.net. Was sich in jeder Version geändert hat, steht im Changelog.
Offizielle Instance: v3.moeshare.eu.
- Funktionen
- Installation
- Erster Start und Einrichtung
- ShareX verbinden
- Andere Programme
- Bildschirm aufnehmen
- Discord-App
- Automatisch teilen
- Texte, Kurzlinks und Alben
- Vorschau für PDF, Markdown, CSV und ZIP
- Datei-Anfragen
- QR-Codes
- Eigene Adressen und eigener Pfad
- Ende-zu-Ende verschlüsselt teilen
- Papierkorb, Statistiken und ZIP
- Große Dateien, Ordner und Versionen
- Gemeinsame Alben
- Duplikate und Volltextsuche
- Aufräumen
- Favoriten und Rückblick
- Später veröffentlichen
- Smarte Alben
- Tags verwalten
- Jahresrückblick
- Befehlspalette
- Bilder bearbeiten
- Bilder optimieren und Wasserzeichen
- Videos kürzen und GIFs
- Videos für alle Browser
- Untertitel
- Inhaltswarnungen
- Beschreibung und Alternativtext
- Reaktionen
- Einbetten
- Per E-Mail teilen
- Vorschauseiten gestalten
- Profilseiten
- Profilbilder
- Diashow und RSS-Feeds
- Eigene Domains
- Impressum und Datenschutz für eigene Domains
- Melden und Moderation
- Push-Benachrichtigungen
- Benachrichtigungen
- Virenscan mit ClamAV
- Gesperrte Dateitypen
- Hotlink-Schutz
- Datenexport
- Import aus anderen Uploadern
- Datenbank
- Dateien in S3
- Einstellungen und Umgebungsvariablen
- Sprache
- Anmelden über andere Dienste
- Anmeldung ohne Passwort
- Einmal-Links
- Hinweis bei neuen Anmeldungen
- Startseite, Impressum und Links
- Eigener Name und Versionshinweise
- Ankündigungen und Wartungsmodus
- App fürs Handy
- Protokoll und Fehlerberichte
- Hinter einem Reverse-Proxy
- Caddy verwalten
- Metriken für Prometheus
- Versionsprüfung
- Update von einer älteren Version
- Datensicherung
- Kommandozeile
- API
- Entwicklung
- Support, Mitwirken und Lizenz
- Hochladen per ShareX, Drag & Drop, Zwischenablage oder Link, mit Vorschaubildern, Video-Standbildern und optionalem HLS-Streaming
- Bildschirm aufnehmen im Browser: Bildschirmfoto oder Bildschirmvideo mit Ton, direkt hochgeladen, auch auf dem Mac und unter Linux
- Discord-App: Anhänge aus Discord per Rechtsklick dauerhaft speichern statt mit Links, die nach einem Tag ablaufen, dazu
/hochladenund/kürzen, auf jedem Server und in DMs - Große Dateien gehen im Browser in Teilen hoch und laufen nach einem Abbruch an derselben Stelle weiter, auch nach dem Neuladen der Seite
- Ordner und ZIP-Archive als Album hochladen, entpackt wird im Browser
- Texte und Code wie in einem Pastebin, mit Syntaxhervorhebung, aus ShareX oder direkt im Browser
- Vorschau für PDF, Markdown, CSV und ZIP: PDFs im Browser, Markdown formatiert, Tabellen als Tabelle und ZIP-Archive mit ihrem Inhalt, aus dem sich einzelne Dateien herunterladen lassen
- Kurzlinks für lange Adressen, auch direkt aus ShareX
- Schutz pro Upload: Ablaufzeit, Passwort oder nur ein einziger Abruf, für Dateien, Texte und Kurzlinks
- Ende-zu-Ende verschlüsselt teilen: Dateien und Texte werden schon im Browser verschlüsselt, den Schlüssel enthält nur der Link, der Server kennt weder Inhalt noch Namen
- Inhaltswarnungen: Bilder und Videos erscheinen erst nach einem Klick, auch die Vorschau in Discord bleibt verschwommen
- Alben und Tags: Dateien ordnen und als Album mit eigener Seite teilen, als ZIP herunterladen und gemeinsam mit anderen Konten füllen
- Versionen: eine Datei durch eine neue Fassung ersetzen, ohne dass sich ihr Link ändert, und jederzeit zu einer älteren zurück
- Duplikate: Mehrfach hochgeladene Dateien zeigt das Dashboard an, auf der Festplatte liegen sie nur einmal
- Volltextsuche in Texten, Code und anderen Textdateien
- Papierkorb: Gelöschtes lässt sich 30 Tage lang zurückholen
- Aufräumen: große, nie aufgerufene und lange nicht mehr aufgerufene Dateien auf einen Blick, gesammelt löschen oder ablaufen lassen
- Favoriten: wichtige Dateien mit einem Stern markieren und mit einem Klick herausfiltern, beim Aufräumen bleiben sie außen vor
- Rückblick „An diesem Tag“: Das Dashboard zeigt, was du am selben Tag vor einem oder mehreren Jahren hochgeladen hast, auf Wunsch kommt morgens eine E-Mail oder Push-Benachrichtigung
- Später veröffentlichen: Uploads erscheinen erst zu einem gewählten Zeitpunkt, bis dahin sehen Besucher nur, wann es so weit ist
- Smarte Alben, die sich selbst füllen: alle Uploads mit einem Tag, eines Dateityps, nur Favoriten oder aus den letzten Tagen
- Tags verwalten: umbenennen, zusammenführen und löschen, smarte Alben und Teilen-Regeln ziehen mit
- Jahresrückblick mit Uploads pro Monat, Wochentag und Uhrzeit, längster Serie, fleißigstem Tag und den beliebtesten Dateien
- Alternativtexte nachtragen: Bilder und Videos ohne Beschreibung der Reihe nach durchgehen, Bild für Bild
- Statistiken pro Datei, Kurzlink und Album: Aufrufe, Vorschauen in Discord und Co., Downloads und woher die Besucher kommen, ganz ohne IP-Adressen
- Adressen nach Wahl: lange ID, kurze Zeichenfolge, Wörter, Emojis, unsichtbare Zeichen oder der Originalname, auf Wunsch über mehrere Domains
- Ansichtsseiten mit Bild-, Video- und Audioplayer in sechs Designs, mit Farben aus der Datei oder eigener Akzentfarbe, wählbarer Schrift, ein- und ausblendbaren Angaben und auf Wunsch eigenem CSS
- Beschreibung und Alternativtext für jede Datei: stehen auf der Ansichtsseite und in Link-Vorschauen, helfen Menschen mit Screenreader und werden durchsucht, auch direkt aus ShareX
- Reaktionen auf Dateien und Alben: Besucher reagieren mit 👍 ❤️ 😂 😮 🔥 👏, ohne Konto und ohne dass MoeShare IP-Adressen speichert. Neue Reaktionen kommen gesammelt per E-Mail oder Push
- Einbetten: Bilder, Videos, Audio, Alben und die Profilkarte mit einem iframe-Code in Blogs und Foren einbauen, dazu fertige Codes für Markdown, BBCode und HTML und oEmbed für WordPress, Ghost und Co.
- Automatisch teilen: Neue Uploads landen als Link bei Discord, Slack, Telegram, ntfy, Matrix oder Mastodon, mit bis zu zehn Regeln, Filtern nach Tag und Dateityp und eigener Nachricht
- Per E-Mail teilen: Dateien und Alben direkt aus dem Dashboard an bis zu fünf Adressen schicken, mit persönlicher Nachricht
- Embed Builder mit Live-Vorschau: eine Standardvorlage für alle und auf Wunsch eigene Vorlagen pro Benutzer, mit Platzhaltern wie
{dateiname}oder{größe} - Profilseiten als Link-in-Bio-Seite: bis zu 30 Links mit Symbolen (automatisch, über 80 Dienste, Emojis oder eigene Bilder), Überschriften und Zeitplan, dazu Klickzahlen und „Kontakt speichern“, ausgewählte Dateien und öffentliche Alben
- Profilbilder mit Zuschnitt im Browser, aus einer Datei oder den eigenen Uploads, bewegte GIFs bleiben bewegt
- Diashow für Alben im Vollbild, mit Tastatur und Wischen, und RSS-Feeds für Profile und Alben
- Eigene Adressen für Dateien, Kurzlinks und Alben wie
/view/urlaub, dazu ein eigener Pfad statt/view/, etwa/max/JrinQR99. Alte Adressen leiten weiter - Eigene Domains pro Konto, bestätigt über einen TXT-Eintrag im DNS, mit kurzen Links wie
bilder.deinname.de/JrinQR99, die Zertifikate holt Caddy von selbst - Impressum und Datenschutz pro Domain: aus einer Vorlage, als eigener Text oder als Link, damit jede eigene Domain rechtlich sauber ist
- Caddy-Verwaltung im Admin-Bereich: Zertifikate mit Ablaufdatum, Warnung per E-Mail und Webhook, Seiten, Weiterleitungen und eine fertige Caddyfile
- Bilder bearbeiten im Browser: zuschneiden, drehen, spiegeln, Pfeile, Rahmen, Text und Verpixeln
- Bilder optimieren als WebP oder AVIF, auf Wunsch verkleinert und mit dem Original als älterer Fassung
- Wasserzeichen aus Text oder Logo, automatisch auf jedem neuen Bild
- Videos kürzen und GIFs erstellen direkt im Dashboard
- Videos für alle Browser: HEVC, 10 Bit, MKV oder AVI bekommen im Hintergrund eine H.264-Fassung, hochkant gefilmte und anamorphe Videos erscheinen im richtigen Format
- Untertitel als SRT oder WebVTT für jedes Video, mehrere Sprachen pro Video
- Datei-Anfragen: ein Link, über den andere dir Dateien schicken, ohne Konto, mit Passwort, Ablaufzeit und Grenzen
- QR-Codes für Dateien, Kurzlinks, Alben, Profile und Datei-Anfragen, für Anfragen mit einem Aushang zum Ausdrucken
- Melden und Moderation: Besucher melden Inhalte, Admins sperren oder löschen sie
- Virenscan mit ClamAV für jeden Upload
- Gesperrte Dateitypen wie
.exeoder.bat, auf Wunsch erkennt MoeShare Programme auch dann, wenn sie umbenannt wurden - Hotlink-Schutz: Fremde Seiten binden deine Bilder und Videos nicht mehr direkt ein, Vorschauen in Discord, Telegram und Co. funktionieren weiter
- E-Mail über SMTP für „Passwort vergessen“, Anmeldelinks, Einladungen und Hinweise zum Konto
- Push-Benachrichtigungen aufs Handy oder den Rechner, etwa bei neuen Dateien in Datei-Anfragen oder einer Anmeldung auf einem neuen Gerät, auch ganz ohne E-Mail-Server
- Startseite mit Statistiken und Upload-Verlauf, im Browser anpassbar oder abschaltbar
- Dein Name: Überall steht der Name deiner Instanz, auch in DNS-Einträgen, Dateinamen und Webhooks. „Läuft mit MoeShare“ und die Versionsnummer lassen sich abschalten
- Ankündigungen und Wartungsmodus: Hinweise für alle oder nur Angemeldete, mit Zeitraum, und eine Wartungsseite, während du am Server arbeitest
- Update-Hinweis: Admins sehen, wenn eine neue Version erschienen ist, auf Wunsch abschaltbar
- Anmeldung mit Passwort, Zwei-Faktor per Authenticator-App und Passkeys, dazu über Discord, GitHub, Google, Microsoft, GitLab oder jeden OpenID-Connect-Anbieter wie Authentik, Keycloak oder Authelia, dort auch mit Rollen aus Gruppen
- Ohne Passwort: Die Anmeldung mit Passwort lässt sich ganz abschalten, dann geht es nur noch mit Passkey, über einen verknüpften Dienst oder mit einem Einmal-Link
- Hinweis bei neuen Anmeldungen: eine E-Mail oder Push-Benachrichtigung, sobald sich jemand auf einem Gerät anmeldet, das bisher nicht dabei war
- Einmal-Links, die genau einmal anmelden und von selbst ablaufen: von Admins erstellt, per E-Mail angefordert oder von anderen Systemen über die API, auf Wunsch erst nach Freigabe durch einen Admin
- Benutzerverwaltung mit Rollen, Speicherlimits, Einladungslinks, Sperren und Aktivitätsprotokoll
- API-Tokens für ShareX und Skripte, mehrere pro Konto und einzeln widerrufbar, die
.sxcu-Dateien für Dateien, Texte und Kurzlinks gibt es per Klick - Datenbank nach Wahl: SQLite, PostgreSQL oder MySQL/MariaDB, der Umzug geht mit einem Befehl
- Umzug von Zipline, XBackBone und Chibisafe mit Konten, Alben, Texten und Kurzlinks, alte Links leiten weiter
- Datenexport: Jede Person lädt alle eigenen Dateien und Angaben als ZIP herunter
- Speicher in S3: AWS S3, Cloudflare R2, Backblaze B2, MinIO, Wasabi und andere S3-Dienste
- Automatische Sicherungen mit Aufbewahrungsregel, im Ordner
db/backupsoder in S3 - Deutsch und Englisch: Jede Person stellt ihre Sprache selbst ein
- App fürs Handy: installierbar wie eine App, Fotos und Links landen über „Teilen“ direkt in MoeShare
- Impressum, Datenschutz und eigene Links im Fuß jeder Seite, als Link oder direkt in MoeShare geschrieben
- Datenschutz: Standortdaten werden aus Fotos entfernt, bevor sie öffentlich erreichbar sind
- Sicherheit: strenge Content Security Policy, hochgeladene HTML- und SVG-Dateien laufen in einer Sandbox
- Benachrichtigungen an Discord, Slack, Matrix, Telegram, ntfy oder einen eigenen Webhook, für jedes Ziel mit eigener Auswahl an Ereignissen
- Metriken für Prometheus unter
/metrics, geschützt mit einem Token - Installationsskript, das Docker oder Node.js, Caddy und die Datenbank in einem Rutsch einrichtet
- Befehlspalette mit Strg+K: hochladen, einen Text anlegen, zu jedem Bereich springen oder Dateien finden, alles mit der Tastatur
- Weboberfläche mit Material You: Farben aus einer Grundfarbe, helles und dunkles Design, auf dem Handy genauso gut wie am PC
Für Linux, macOS und das iPhone gibt es fertige Einstellungen unter Konto › API, siehe Andere Programme. MagicCap funktioniert ebenfalls.
Am schnellsten geht es mit dem Installationsskript. Von Hand braucht MoeShare Node.js 24 oder neuer oder Docker. Das Docker-Image bringt Node.js 26 und FFmpeg schon mit. Ohne Docker installierst du FFmpeg für Video-Vorschauen, Streaming, gekürzte Videos und GIFs selbst, etwa mit apt install ffmpeg, brew install ffmpeg oder winget install ffmpeg. MoeShare findet es über den PATH, alternativ gibst du den Pfad mit FFMPEG_PATH an. Die Weboberfläche liegt fertig gebaut im Repository, ein eigener Build-Schritt ist nicht nötig.
Auf einem Linux-Server mit Debian, Ubuntu, Fedora, Rocky, Alma, openSUSE, Arch oder Alpine richtet ein Skript alles ein: Docker oder Node.js, die Dateien von MoeShare, eine .env mit zufälligen Passwörtern für die Datenbank, Caddy für HTTPS und, ohne Docker, einen systemd-Dienst mit eigenem Benutzer.
curl -fsSL https://moeshare.moestudio.net/install.sh | sudo bashDas Skript fragt nach Installationsart, Domain und Datenbank und zeigt am Ende den Link zum Einrichtungsassistenten. Ohne Rückfragen geht es mit Optionen:
curl -fsSL https://moeshare.moestudio.net/install.sh | sudo bash -s -- --docker --domain share.example.com --email du@example.com --db postgres -y| Option | Bedeutung |
|---|---|
--docker / --node |
mit Docker (empfohlen) oder mit Node.js und systemd |
--dir PFAD |
Installationsordner, Standard /opt/moeshare |
--domain NAME |
Domain für HTTPS über Caddy |
--email ADRESSE |
E-Mail-Adresse für Let’s Encrypt |
--db ART |
sqlite, postgres oder mariadb (nur Docker) |
--clamav |
zusätzlich den Virenscanner starten (nur Docker) |
--port ZAHL |
Port von MoeShare, Standard 3000 |
--ref NAME |
Git-Branch oder Tag, Standard main |
--update |
bestehende Installation aktualisieren |
--no-start |
alles vorbereiten, aber nicht starten |
-y |
keine Fragen, Standardwerte nehmen |
Mit Domain bindet das Skript MoeShare nur an 127.0.0.1, erreichbar ist es dann ausschließlich über Caddy. Ein Update holst du mit curl -fsSL https://moeshare.moestudio.net/install.sh | sudo bash -s -- --update. Das Skript liegt auch im Repository als install.sh, wer es vorher lesen möchte, lädt es erst herunter und startet es dann mit sudo bash install.sh.
Das Image liegt in der GitHub Container Registry unter ghcr.io/maximiliangt500/moeshare und läuft auf amd64 und arm64, also auch auf dem Raspberry Pi. Für den Start reicht die docker-compose.yml:
mkdir moeshare && cd moeshare
curl -O https://raw.githubusercontent.com/MaximilianGT500/moeshare/main/docker-compose.yml
docker compose up -d
docker compose logs -f moeshareIn den Logs erscheint der Link zum Installationsassistenten. Datenbank und Uploads landen in den Ordnern db/ und uploads/ neben der docker-compose.yml. Soll MoeShare gleich unter deiner Domain mit HTTPS laufen, lädst du vor dem Start noch die Caddyfile herunter, siehe Hinter einem Reverse-Proxy.
Was der Stack mitbringt:
- Eigener Benutzer: MoeShare läuft im Container nicht als root. Beim Start bekommen
db/unduploads/den Besitzer ausPUIDundPGID(Standard1000). Passe beide an, wenn die Ordner auf dem Host einem anderen Benutzer gehören sollen. - Abgesichert: schreibgeschütztes Dateisystem bis auf die beiden Ordner und
/tmp, keine zusätzlichen Rechte (no-new-privileges, nur die nötigen Capabilities). - Health-Check über
/healthz, Docker zeigt den Zustand mitdocker compose ps. - Logs mit Rotation (3 × 10 MB) und Zeitzone aus
TZ. - Sauberes Beenden: laufende Uploads dürfen bis zu 20 Sekunden fertig werden.
Updates holst du mit:
docker compose pull
docker compose up -dZu jeder veröffentlichten Version gibt es neben latest eigene Tags wie 3.2.0, 3.2 und 3. Selbst bauen geht mit docker build -t ghcr.io/maximiliangt500/moeshare:latest . im geklonten Repository, docker compose up -d nimmt dann dieses Image.
Für PostgreSQL und MariaDB liegen im Ordner docker/ zwei Ergänzungen zur docker-compose.yml. Sie starten die Datenbank als eigenen Container und verbinden MoeShare damit. Für PostgreSQL:
mkdir -p docker
curl -o docker/postgres.yml https://raw.githubusercontent.com/MaximilianGT500/moeshare/main/docker/postgres.yml
echo "POSTGRES_PASSWORD=$(openssl rand -hex 24)" >> .env
echo "COMPOSE_FILE=docker-compose.yml:docker/postgres.yml" >> .env
docker compose up -dFür MariaDB nimmst du docker/mariadb.yml und MARIADB_PASSWORD. Durch COMPOSE_FILE in der .env nutzt docker compose beide Dateien automatisch, unter Windows trennt ein Semikolon statt eines Doppelpunkts die Dateien. Die Daten der Datenbank liegen im Ordner postgres/ bzw. mariadb/. Das Passwort steht später in der Datenbank-Adresse, nimm deshalb nur Buchstaben und Ziffern, wie es openssl rand -hex 24 erzeugt.
Wie du eine bestehende Installation umziehst, steht unter Datenbank. Auf die gleiche Art startet docker/clamav.yml einen Virenscanner neben MoeShare, siehe Virenscan mit ClamAV.
git clone https://github.com/MaximilianGT500/moeshare.git
cd moeshare
npm install
npm startFür den Dauerbetrieb eignet sich PM2, auch im Cluster-Modus mit mehreren Prozessen:
npm install -g pm2
pm2 start index.js --name moeshare -i max
pm2 saveSolange es noch kein Konto gibt, zeigt MoeShare bei jedem Start einen Link mit Einrichtungscode in der Konsole:
┌──────────────────────────────────────────────────────────────────────────┐
│ MoeShare ist noch nicht eingerichtet. Öffne den Installationsassistenten: │
│ │
│ http://localhost:3000/setup?token=… │
└──────────────────────────────────────────────────────────────────────────┘
Läuft MoeShare auf einem anderen Rechner oder hinter einer Domain, ersetzt du http://localhost:3000 durch die passende Adresse. Nur wer den Code kennt, kann das erste Konto anlegen. Der Link bleibt 30 Tage gültig und gilt auch nach einem Neustart.
Der Assistent führt durch:
- Systemprüfung von Datenbank, Speicherordner, FFmpeg und Node.js
- Datenbank: SQLite, PostgreSQL oder MySQL/MariaDB, mit Verbindungstest
- Admin-Konto mit Benutzername und Passwort
- Seite: Name, öffentliche Adresse, Sprache, Grundfarbe und Symbol
- Startseite: Startseite mit Statistiken, direkt zur Anmeldung oder Weiterleitung auf eine andere Seite
- Uploads: maximale Dateigröße, Speicher pro Konto, Adressstil und die Verarbeitung nach dem Hochladen
- Anmeldung: wer ein Konto bekommt, Zwei-Faktor-Pflicht und Passkeys
- Benachrichtigungen über einen Discord-Webhook, auf Wunsch mit Testnachricht
- Übersicht und Abschluss
Danach bist du angemeldet und kannst direkt die ShareX-Dateien mitnehmen. Alles lässt sich später unter Admin › Einstellungen ändern, dort richtest du auch Impressum, Datenschutz, S3, Sicherungen, E-Mail, eigene Domains und die Anmeldung über andere Dienste ein.
Unter Konto › ShareX und API erstellst du ein Token und lädst die fertigen .sxcu-Dateien herunter, je eine für Dateien, Texte und Kurzlinks. Ein Doppelklick richtet ShareX ein. Bilder und Dateien gehen dann direkt zu MoeShare, Texte aus der Zwischenablage werden zu Text-Seiten und „URL kürzen“ erzeugt Kurzlinks. Die Links zum Ansehen, für die Vorschau und zum Löschen trägt ShareX selbst ein.
Wer Uploads aus ShareX gleich schützen oder einsortieren will, ergänzt in der .sxcu unter Headers diese Angaben. Alle sind optional und gelten für den einzelnen Upload, ohne Angabe nimmt MoeShare die eigenen Vorlieben aus Konto › Einstellungen und danach die Vorgaben des Servers.
| Header | Beispiel | Wirkung |
|---|---|---|
X-Expires |
7d |
Löschen nach Minuten (30m), Stunden (6h), Tagen (7d) oder Wochen (2w), never für nie |
X-Password |
geheim |
Datei, Text oder Kurzlink nur mit Passwort |
X-Once |
true |
Nur ein einziger Abruf, danach ist die Datei weg |
X-Max-Views |
5 |
Höchstens so viele Abrufe |
X-Url-Style |
words |
Adressstil: uuid, random, words, emoji, invisible oder original |
X-Domain |
https://img.example.com |
Eine der unter Admin › Einstellungen eingetragenen Domains oder eine eigene Domain, random für eine zufällige |
X-Title |
Mein Skript |
Titel für Texte und Dateien, Umlaute URL-kodiert |
X-Description |
Urlaub%20am%20See |
Beschreibung mit bis zu 2000 Zeichen, URL-kodiert, %0A für einen Zeilenumbruch |
X-Alt |
Steg%20im%20Abendlicht |
Alternativtext für Bilder und Videos, bis zu 500 Zeichen, URL-kodiert |
X-Syntax |
python |
Sprache für die Hervorhebung von Texten |
X-Tags |
urlaub,2026 |
Tags, durch Kommas getrennt |
X-Album |
aB3dE9 |
Code oder ID eines eigenen oder mit dir geteilten Albums |
X-Warning |
Spoiler |
Inhaltswarnung mit diesem Text, true für eine Warnung ohne Text |
X-Publish-At |
+2h |
Später veröffentlichen: in Minuten (30m), Stunden (2h), Tagen (1d) oder Wochen (1w), als Datum wie 2026-12-24T18:00:00+01:00 oder als Unix-Zeit in Millisekunden, höchstens ein Jahr im Voraus |
X-Optimize |
false |
Bild optimieren (true) oder unverändert speichern (false), sofern der Server optimiert |
X-Watermark |
false |
Mit false bekommt dieses Bild kein Wasserzeichen |
X-Slug |
urlaub |
Eigene Adresse für Datei oder Text, etwa /view/urlaub. Umlaute URL-kodiert |
X-Code |
discord |
Eigenes Kürzel für einen Kurzlink, etwa /s/discord |
Unter Konto › API › Andere Programme gibt es fertige Einstellungen für weitere Programme. Ein Klick auf „Einrichten“ legt ein eigenes Token an und zeigt das passende Skript mit deinem Server und deinem Token:
| Programm | System | Was es tut |
|---|---|---|
| Flameshot | Linux | Bereich auswählen, hochladen, Link in die Zwischenablage, unter X11 und Wayland |
| KDE Spectacle | Linux | dasselbe mit dem Bildschirmfoto-Programm von KDE Plasma |
| Bildschirmfoto auf dem Mac | macOS | nutzt das eingebaute screencapture, mit Kurzbefehle auf eine Taste legbar |
| Kurzbefehle | iPhone, iPad, Mac | Schritt-für-Schritt-Anleitung für einen Kurzbefehl, der Fotos hochlädt und den Link kopiert |
| curl | überall | ein Befehl für eigene Skripte und Automationen |
Die Skripte brauchen nur curl, für die Zwischenablage unter Linux wl-clipboard oder xclip. Du speicherst sie etwa als ~/.local/bin/…, machst sie mit chmod +x ausführbar und legst in den Systemeinstellungen ein Tastenkürzel dafür an.
Im Dashboard nimmt der Knopf Bildschirm aufnehmen neben „Von URL hochladen“ direkt im Browser auf, ganz ohne ShareX:
- Bildschirmfoto: Du wählst einen Bildschirm, ein Fenster oder einen Tab, MoeShare macht ein Bild davon und lädt es sofort hoch.
- Bildschirmvideo: Die Aufnahme läuft, bis du in der Leiste unten auf Stopp klickst, pausieren und verwerfen geht dort auch. Danach siehst du das Video noch einmal und lädst es hoch oder speicherst es nur auf dem Rechner. Auf Wunsch kommen der Ton vom Bildschirm und dein Mikrofon mit ins Video.
Videos landen als WebM (in Safari als MP4) in der normalen Warteschlange, große Aufnahmen gehen in Teilen hoch. Die Aufnahme braucht einen aktuellen Browser am Rechner, auf Handys gibt es den Knopf nicht, weil dort kein Browser den Bildschirm freigibt.
Anhänge in Discord bekommen Links, die nach rund einem Tag ablaufen. Mit der Discord-App landen sie dauerhaft in MoeShare:
- Rechtsklick auf eine Nachricht › Apps › „In MoeShare speichern“, mit dem Namen deiner Instanz, speichert alle Anhänge der Nachricht, bis zu zehn auf einmal.
/hochladen(englisch/upload) speichert eine angehängte Datei./kürzen(englisch/shorten) kürzt einen Link, wenn der Link-Kürzer an ist.
Die Antwort mit den Links sieht nur, wer den Befehl benutzt hat. Mit der Option öffentlich zeigen /hochladen und /kürzen den Link allen im Kanal. Die App erkennt Konten am verknüpften Discord, wer sie nutzen will, meldet sich einmal mit Discord an oder verknüpft Discord unter Konto › Sicherheit. Es gelten dieselben Regeln wie beim Hochladen: Speicherlimits, gesperrte Dateitypen und der Virenscan.
Einrichten, mit derselben Anwendung wie für die Anmeldung über Discord:
- Im Developer Portal unter General Information den Public Key kopieren und unter Admin › Einstellungen › Anmeldedienste › Discord › Discord-App eintragen, die App einschalten und speichern.
- Die dort angezeigte Adresse
https://share.example.com/api/discord/interactionsim Developer Portal als Interactions Endpoint URL eintragen. Discord prüft sie beim Speichern. - Unter Installation „User Install“ einschalten, damit die App auf jedem Server und in DMs geht, und die App über den Installationslink zu deinem Discord-Konto hinzufügen.
- In MoeShare auf Befehle bei Discord eintragen klicken. Nach einer Namensänderung deiner Instanz das noch einmal tun, damit der Rechtsklick-Befehl den neuen Namen trägt.
Wer neue Uploads ohnehin in einem Kanal oder auf Mastodon teilt, lässt das MoeShare erledigen. Unter Konto › Einstellungen › Automatisch teilen legst du bis zu zehn Regeln an. Jede Regel schickt passende Uploads als Link an genau ein Ziel, mit dem Titel der Datei, falls sie einen hat. Diese Ziele gibt es:
| Ziel | Was du brauchst |
|---|---|
| Discord | Webhook-Adresse: Kanal bearbeiten › Integrationen › Webhooks › „Webhook-URL kopieren“. Discord zeigt darunter dieselbe Vorschau wie bei einem kopierten Link |
| Slack | Webhook-Adresse einer App mit „Incoming Webhooks“ (https://hooks.slack.com/…) |
| Telegram | Bot-Token von @BotFather und die Chat-ID (Zahl oder @kanalname). Der Bot muss im Kanal oder in der Gruppe sein |
| ntfy | Server (leer für ntfy.sh), Thema und auf Wunsch ein Zugangstoken für geschützte Themen. Ein Tipp auf die Benachrichtigung öffnet die Datei |
| Matrix | Homeserver, Raum (!id:server oder #alias:server) und das Zugangstoken eines Kontos, das im Raum ist |
| Mastodon | Instanz und ein Zugangstoken einer Anwendung mit dem Recht write:statuses, dazu die Sichtbarkeit (öffentlich, nicht gelistet oder nur für Follower) |
- Filter: Mit einem Tag wie
urlaubgehen nur Uploads mit diesem Tag raus, etwa aus ShareX mitX-Tags: urlaub. Dazu wählst du auf Wunsch Dateitypen, etwa nur Bilder und Videos. So landen Fotos in der Familiengruppe und Texte im Arbeitskanal. - Eigene Nachricht: Eine Vorlage mit Platzhaltern bestimmt den Text, etwa
📸 Neu von {konto}: {titel}und darunter{link}. Es gibt{link},{titel},{beschreibung},{datei},{tags}und{konto}, auf Englisch auch{title},{description},{file}und{account}.{link}muss vorkommen. Eine Vorschau mit Beispielwerten zeigt das Ergebnis, Formatierungszeichen aus Titeln und Beschreibungen werden für jedes Ziel passend maskiert. - Nie geteilt werden Dateien mit Passwort, mit Aufruflimit, Ende-zu-Ende verschlüsselte Dateien, neue Fassungen, Dateien aus Datei-Anfragen, Uploads über die Discord-App und alles aus dem Import. Geplante Dateien gehen raus, sobald sie erscheinen.
- Testen schickt sofort eine Testnachricht. Lehnt ein Ziel zehnmal hintereinander ab oder meldet es, dass Webhook, Token oder Kanal nicht mehr gelten, pausiert MoeShare die Regel und zeigt den Grund an. Wieder einschalten setzt den Fehler zurück, bei zu vielen Nachrichten auf einmal wartet MoeShare einfach.
- Webhooks und Tokens liegen verschlüsselt in der Datenbank, angezeigt wird nur ein Hinweis wie die letzten Ziffern oder das Thema. Beim Bearbeiten bleibt ein gespeichertes Token erhalten, solange du das Feld leer lässt. Erwähnungen wie
@everyonesind in Discord-Nachrichten abgeschaltet.
Admins schalten die Funktion unter Admin › Einstellungen › Funktionen › Teilen und Reaktionen für alle ab. Das ist unabhängig von den Benachrichtigungen, die Admins über Ereignisse auf dem ganzen Server informieren. Über die API verwaltest du die Regeln unter /api/account/autoshare.
Texte lädst du aus ShareX, über die API oder im Dashboard mit „Neuer Text“ hoch. MoeShare zeigt sie mit Syntaxhervorhebung, erkennt die Sprache auf Wunsch selbst und bietet die Rohfassung und einen Download an. Wie groß ein Text sein darf, legst du unter Admin › Einstellungen › Uploads fest.
Kurzlinks stehen unter /s/<code> und leiten auf die Zieladresse weiter. Im Dashboard unter Links siehst du alle Kurzlinks mit Klickzahl, änderst sie oder schützt sie mit Passwort, Ablaufzeit und einer Höchstzahl an Klicks.
Alben legst du im Dashboard unter Alben an oder wählst beim Hochladen ein Album aus. Jedes Album hat eine eigene Seite unter /a/<code> mit Titel, Beschreibung und Titelbild. Es ist entweder nur für dich sichtbar, für alle mit dem Link oder öffentlich, dann steht es auch auf deiner Profilseite. Ein Passwort geht zusätzlich. Geschützte Dateien zeigt ein Album erst, wenn ihr Passwort eingegeben wurde.
Ein Passwort, eine Ablaufzeit oder ein einmaliger Abruf lässt sich bei jedem Upload setzen und später im Dashboard ändern. Abgelaufene Dateien löscht MoeShare selbst.
Kurzlinks und Alben lassen sich unter Admin › Einstellungen › Funktionen abschalten.
Viele Dateien zeigt die Ansichtsseite direkt an, statt nur einen Download anzubieten:
- PDF im eingebauten PDF-Viewer des Browsers. Auf Handys, die PDFs nicht innerhalb einer Seite anzeigen, öffnet „PDF öffnen“ die Datei im Viewer des Geräts.
- Markdown formatiert, mit Überschriften, Listen, Aufgabenlisten, Tabellen, Zitaten und Code mit Syntaxhervorhebung. HTML im Text bleibt Text, und Bilder von fremden Seiten erscheinen nur als Link. Über „Quelltext“ siehst du die Datei, wie sie ist.
- CSV und TSV als Tabelle mit fester Kopfzeile, Zahlen stehen rechtsbündig. Ob Komma, Semikolon, Tabulator oder senkrechter Strich die Spalten trennt, erkennt MoeShare selbst. Die Tabelle zeigt die ersten 1.000 Zeilen, „Text“ die Rohfassung.
- ZIP-Archive mit ihrem Inhalt als Ordnerbaum, mit Größe und Datum jeder Datei. Einzelne Dateien lädst du direkt herunter, ohne das ganze Archiv zu laden. Bei verschlüsselten Einträgen und seltenen Packverfahren bleibt nur der Download des ganzen Archivs. Angezeigt werden bis zu 10.000 Einträge.
Markdown und CSV kommen wie andere Texte bis 512 KB in die Vorschau, größere Dateien gibt es als Download.
Mit einer Datei-Anfrage schicken dir andere Dateien, ohne ein Konto zu brauchen. Unter Dashboard › Anfragen legst du eine an und verschickst den Link, etwa share.example.com/r/Xk3…. Die Seite dahinter zeigt Titel und Nachricht, nimmt Dateien per Drag & Drop an und zeigt den Fortschritt jeder Datei.
Pro Anfrage stellst du ein:
- wie lange sie offen ist (oder ohne Ende) und ob ein Passwort nötig ist
- welche Dateien sie annimmt: alle, nur Bilder, nur Videos, Medien oder Dokumente
- wie viele Dateien höchstens, wie groß jede sein darf und wie viel zusammen
- ob nach dem Namen gefragt wird und in welches Album die Dateien kommen
- ob du per E-Mail oder Push Bescheid bekommst. Weitere Uploads innerhalb von 15 Minuten fasst MoeShare zusammen
Die Dateien landen in deinem Konto und zählen zu deinem Speicher, im Dashboard siehst du, wer was geschickt hat. Eine Anfrage lässt sich jederzeit schließen und wieder öffnen. Admins schalten die Funktion unter Admin › Einstellungen › Funktionen ab und legen fest, wie viele offene Anfragen ein Konto haben darf (Standard 20).
Bei Dateien (im Teilen-Menü der Dateiansicht), Kurzlinks, Alben, deinem Profil und Datei-Anfragen gibt es einen QR-Code, zum Abscannen mit dem Handy oder zum Speichern als PNG oder SVG. Für Datei-Anfragen druckst du daraus einen Aushang mit Titel, Nachricht, großem QR-Code und Adresse, etwa für eine Feier, auf der alle ihre Fotos hochladen sollen.
Statt einer zufälligen Adresse bekommt eine Datei auf Wunsch eine selbst gewählte, etwa /view/urlaub. Das geht genauso für Texte, Kurzlinks (/s/discord) und Alben (/a/sommer-2026). Im Dashboard trägst du die Adresse beim Anlegen eines Textes, Kurzlinks oder Albums ein oder änderst sie später beim Bearbeiten. ShareX und die API schicken sie als Header X-Slug bzw. X-Code oder als Feld slug bzw. code. Erlaubt sind Buchstaben samt Umlauten, Ziffern, Punkte, Binde- und Unterstriche, vorne und hinten steht ein Buchstabe oder eine Ziffer. Groß- und Kleinschreibung zählt beim Vergeben nicht: Gibt es Urlaub schon, ist auch urlaub vergeben.
Änderst du eine Adresse, leitet die alte auf die neue weiter und bleibt für andere gesperrt. So funktionieren geteilte Links weiter. Eigene Adressen sind leichter zu erraten als zufällige, für Privates setzt du besser ein Passwort.
Mit einem eigenen Pfad steht in deinen Links dein Name statt /view/, etwa https://share.example.com/max/JrinQR99. Den Pfad legst du unter Konto › Einstellungen fest: 2 bis 32 Kleinbuchstaben, Ziffern, Binde- und Unterstriche. Namen, die der Server selbst braucht, wie admin oder api, und die Benutzernamen anderer Konten gehen nicht. Links mit /view/ funktionieren weiter, und /max allein öffnet deine Profilseite, sofern sie eingeschaltet ist. Änderst du den Pfad, leiten alte Links weiter und der alte Pfad bleibt für andere gesperrt. Admins geben den Pfad eines Kontos unter Admin › Benutzer wieder frei.
Beides schaltest du unter Admin › Einstellungen › Funktionen ab. Ohne eigene Pfade leiten solche Links wieder auf /view/ weiter.
Dateien und Texte lassen sich schon im Browser verschlüsseln, bevor sie hochgeladen werden. Schalte dafür im Dashboard unter Upload-Optionen „Ende-zu-Ende verschlüsseln“ ein, beim neuen Text steht derselbe Schalter unter „Ablauf, Schutz und Adresse“. Der Schlüssel steht nur im Link, hinter #k=. Diesen Teil einer Adresse schicken Browser nie an den Server. MoeShare speichert also nur verschlüsselte Daten und kennt weder Inhalt noch Dateinamen, auch Admins nicht.
Wer den Link öffnet, lädt die Datei und entschlüsselt sie im Browser. Danach zeigt die Ansichtsseite sie wie gewohnt: Bilder, Videos, Audio, PDFs, Markdown und Code mit Syntaxhervorhebung. Fehlt der Schlüssel im Link, lässt er sich auf der Seite einfügen. Passwort, Ablaufzeit und einmaliger Abruf funktionieren zusätzlich wie bei jeder anderen Datei.
Das Dashboard merkt sich die Schlüssel deiner Uploads in diesem Browser (im localStorage), so kopierst du den vollständigen Link auch später noch. In einem anderen Browser oder nach dem Löschen der Browserdaten hast du ihn nur noch, wenn du ihn selbst aufgehoben hast. Ohne Schlüssel lässt sich die Datei nicht mehr öffnen, von niemandem.
Weil der Server den Inhalt nicht kennt, gibt es für verschlüsselte Dateien keine Vorschaubilder, keine Volltextsuche und keine Bildbearbeitung, und ClamAV kann sie nicht prüfen. In Discord und anderen Diensten erscheint nur „Verschlüsselte Datei“. Eine Datei darf bis zu 1 GB groß sein, weil der Browser sie zum Anzeigen ganz in den Arbeitsspeicher lädt. Wer eine verschlüsselte Datei meldet, schickt den Link mit Schlüssel mit, damit Admins sie prüfen können.
Unter Admin › Einstellungen › Uploads › Ende-zu-Ende-Verschlüsselung schaltest du die Funktion ab. Dann nimmt der Server keine verschlüsselten Dateien mehr an, schon hochgeladene bleiben erreichbar.
Technisch: AES-256-GCM in Blöcken zu 1 MB, Dateiname und Typ liegen verschlüsselt mit in der Datei. Die Dateien enden auf .mse, beim Hochladen prüft der Server nur ihren Aufbau. ShareX lädt weiter unverschlüsselt hoch.
Papierkorb: Gelöschte Dateien landen erst im Papierkorb und sind ab sofort nicht mehr erreichbar. Direkt nach dem Löschen bietet das Dashboard „Rückgängig“ an, später holst du sie unter Papierkorb zurück oder löschst sie endgültig. Nach 30 Tagen räumt MoeShare selbst auf. Bis dahin zählen die Dateien weiter zum Speicher des Kontos. Admins sehen unter Admin › Dateien auch die Papierkörbe aller Konten. Auch Löschen über ShareX oder die API legt Dateien in den Papierkorb.
Statistiken: MoeShare zählt Aufrufe der Ansichtsseite, Vorschauen in Discord, Telegram und anderen Diensten, Downloads und Abrufe des Direktlinks außerhalb von MoeShare. Dazu kommt, von welcher Seite die Besucher kamen. Eigene Aufrufe zählen nicht mit. IP-Adressen, Cookies oder Gerätedaten speichert MoeShare dafür nicht, es bleiben nur Summen pro Tag. Im Dashboard unter Statistik siehst du alle Dateien zusammen und die meistgesehenen, jede Datei, jeder Kurzlink und jedes Album hat außerdem eine eigene Statistik. Die Tageswerte bleiben ein Jahr.
ZIP: Markierst du im Dashboard mehrere Dateien, lädst du sie mit einem Klick als ZIP herunter. Alben gibt es auf ihrer Seite ebenfalls als ZIP, geschützte Dateien bleiben dabei außen vor.
Unter Admin › Einstellungen › Funktionen legst du fest, wie lange Dateien im Papierkorb bleiben und wie lange die Statistik zurückreicht, oder schaltest Papierkorb, Statistiken und ZIP-Download ab.
Große Dateien: Im Dashboard gehen Dateien über 8 MB in Teilen hoch. Bricht die Verbindung ab, versucht MoeShare es selbst noch einmal und macht an derselben Stelle weiter, laufende Uploads lassen sich auch pausieren. Lädst du die Seite neu oder schließt den Browser, bietet das Dashboard beim nächsten Mal an, den Upload fortzusetzen. Dafür wählst du dieselbe Datei noch einmal aus. Unfertige Uploads hebt MoeShare 24 Stunden auf und hält so lange den Platz dafür frei. Weil jedes Teil eine eigene Anfrage ist, kommen auch Dateien an, die größer sind als das Limit eines Proxys, etwa die 100 MB pro Anfrage bei Cloudflare. ShareX lädt weiter in einem Stück hoch, für eigene Skripte gibt es die API.
Ordner und ZIP-Archive: Ziehst du einen Ordner ins Dashboard oder wählst ihn über „Ordner hochladen“ aus, wird daraus ein Album mit dem Namen des Ordners. Mehrere Ordner ergeben mehrere Alben, Unterordner zählen zum Ordner darüber, mehr als 500 Dateien verteilt MoeShare auf mehrere Alben. Name und Sichtbarkeit legst du vorher fest. Eine einzelne ZIP-Datei entpackt MoeShare auf Wunsch direkt im Browser und legt die Dateien ebenfalls in ein neues Album, oder lädt sie als ZIP hoch.
Versionen: Über „Versionen“ im Menü einer Datei lädst du eine neue Fassung hoch. Links, Statistiken, Alben und Tags bleiben dabei gleich, alte Direktlinks leiten auf die neue Fassung weiter. Die bisherigen Fassungen stehen in der Liste darunter: ansehen, herunterladen, wiederherstellen oder löschen. Neue Fassungen entstehen auch, wenn du ein Bild im Editor ersetzt, ein Video kürzt oder MoeShare ein Bild optimiert und das Original aufhebt. Ältere Fassungen zählen zum Speicher. Wie viele pro Datei bleiben (Standard 10, Originale zählen nicht mit), legst du unter Admin › Einstellungen › Uploads fest. Dort schaltest du Versionen und fortsetzbare Uploads auch ab.
Ein Album lässt sich mit bis zu 20 anderen Konten teilen. Öffne es unter Alben, trage bei „Gemeinsames Album“ einen Benutzernamen ein und tippe auf „Einladen“. Die Person sieht das Album ab sofort in ihrem Dashboard, auch wenn es privat ist. Mitglieder fügen eigene Dateien hinzu, laden direkt ins Album hoch, auch über ShareX mit X-Album, und nehmen ihre eigenen Beiträge wieder heraus. Titel, Sichtbarkeit, Reihenfolge und Mitglieder bestimmt nur, wem das Album gehört. Wer das Album verlässt oder entfernt wird, nimmt seine Dateien wieder mit, sie bleiben im eigenen Konto. Auf der Albumseite steht, wer etwas beigetragen hat, und das ZIP enthält die Dateien aller Mitglieder.
Duplikate: Lädst du eine Datei hoch, die schon in deinem Konto liegt, sagt das Dashboard es direkt. Gibt es mehrfach vorhandene Dateien, zeigt die Filterleiste „Duplikate“. Dort stehen sie nach Gruppen, und die Kopien löschst du mit einem Klick. Auf der Festplatte liegt jede Datei eines Kontos trotzdem nur einmal und zählt auch nur einmal zum Speicher, MoeShare verknüpft die Kopien per Hardlink. Das gilt für Dateien im Ordner uploads/, in S3 liegt jede Kopie einzeln. Klappt das Verknüpfen nicht, etwa auf manchen Netzlaufwerken, bleibt die Kopie eine eigene Datei. Unter Admin › Einstellungen › Uploads schaltest du das Zusammenlegen ab, das Erkennen bleibt.
Volltextsuche: Die Suche im Dashboard findet Wörter auch im Inhalt von Texten, Code und anderen Textdateien, bei großen Dateien in den ersten 512 KB, und zeigt die Fundstelle direkt an der Datei. Unter Admin › Einstellungen › Funktionen lässt sie sich auf Dateinamen und Titel beschränken.
Nach dem Update auf 3.2 berechnet MoeShare für vorhandene Dateien im Hintergrund Prüfsummen und nimmt bestehende Texte in den Suchindex auf, ein paar Dutzend Dateien pro Minute.
Unter Dashboard › Aufräumen findest du Dateien, die viel Platz brauchen oder die niemand mehr ansieht. Drei Listen stehen zur Wahl:
- Groß: die größten Dateien zuerst, hier lässt sich am meisten Platz schaffen
- Nie aufgerufen: älter als zwei Wochen und noch kein einziges Mal geöffnet, auch nicht über den Direktlink
- Lange nicht aufgerufen: seit einem halben Jahr nicht mehr geöffnet, die ältesten zuerst. Ist die Statistik abgeschaltet, weiß MoeShare nicht, wann eine Datei zuletzt aufgerufen wurde, und zeigt alle Dateien, die älter als ein halbes Jahr sind.
Über jeder Liste steht, wie viele Dateien es sind und wie viel Platz sie zusammen belegen. Markierte Dateien legst du gesammelt in den Papierkorb oder lässt sie in einem Tag, einer Woche oder 30 Tagen ablaufen. Favoriten tauchen in keiner Liste auf. Über die API liefert GET /api/files/cleanup dieselben Listen.
Favoriten: Im Menü einer Datei, in der großen Ansicht oder für mehrere markierte Dateien auf einmal setzt „Zu Favoriten“ einen Stern. Über den Dateien erscheint dann der Filter Favoriten, der nur noch diese Dateien zeigt, auch zusammen mit Suche, Dateityp und Tag. Die Befehlspalette kennt „Favoriten zeigen“. Favoriten bleiben beim Aufräumen außen vor, damit dort nichts Wichtiges aus Versehen gelöscht wird. Über die API liefert GET /api/files?starred=1 nur Favoriten, PATCH /api/files/:id mit { "starred": true } setzt den Stern.
Rückblick: Hast du am heutigen Tag vor einem oder mehreren Jahren etwas hochgeladen, zeigt das Dashboard oben die Karte An diesem Tag, nach Jahren sortiert und bis zu zehn Jahre zurück. Ein Klick öffnet die Datei in der großen Ansicht, mit den Pfeiltasten blätterst du durch alle Erinnerungen. „Für heute ausblenden“ schließt die Karte bis morgen. Dateien im Papierkorb und gesperrte Dateien erscheinen nicht. Die Liste gibt es unter GET /api/files/memories. Wer die Erinnerungen nicht verpassen will, schaltet unter Konto › Einstellungen „An diesem Tag“ ein, per E-Mail oder als Push-Benachrichtigung auf einzelnen Geräten. Die Nachricht kommt einmal am Tag ab 9 Uhr deutscher Zeit, und nur, wenn es etwas zu erinnern gibt.
Ein Upload muss nicht sofort sichtbar sein. Unter Bearbeiten schaltest du „Später veröffentlichen“ ein und wählst Datum und Uhrzeit, Knöpfe wie „In 1 Stunde“, „Morgen 9 Uhr“ oder „In einer Woche“ sparen das Tippen. In den Upload-Optionen gilt das für alles, was du in diesem Fenster hochlädst, ShareX schickt dafür den Header X-Publish-At, etwa +2h. Höchstens ein Jahr im Voraus ist möglich.
Bis dahin siehst nur du die Datei. Besucher, die den Link schon haben, lesen „Diese Datei erscheint am … um … Uhr“. Der Direktlink antwortet bis dahin nicht, eine Einbettung zeigt nur eine Karte mit dem Zeitpunkt, Profil, öffentliche Alben und Feeds lassen die Datei aus. Im Dashboard trägt die Kachel eine Uhr, und der Filter Geplant zeigt alle geplanten Dateien auf einen Blick. Zum gewählten Zeitpunkt erscheint die Datei von selbst, und erst dann gehen die Regeln zum automatischen Teilen los. „Später veröffentlichen“ auszuschalten veröffentlicht sie sofort. Über die API setzt PATCH /api/files/:id mit { "publishAt": "2026-12-24T18:00:00+01:00" } den Zeitpunkt, { "publishAt": null } veröffentlicht sofort, GET /api/files?scheduled=1 listet geplante Dateien.
Ein smartes Album füllt sich selbst. Beim Anlegen eines Albums wählst du „Füllt sich selbst“ und legst die Regel fest: ein Tag, ein Dateityp, nur Favoriten und ein Zeitraum wie die letzten 7, 30 oder 90 Tage oder das letzte Jahr, einzeln oder kombiniert. Ohne Angaben zeigt es alle deine Uploads. Neue passende Uploads erscheinen sofort, ohne dass du sie hineinlegen musst, die neuesten zuerst und höchstens 500.
Dateien mit Passwort oder Aufruflimit und verschlüsselte Dateien bleiben draußen, Besucher sehen geplante und gesperrte Dateien erst, wenn sie öffentlich sind. Smarte Alben teilst du wie jedes andere Album, mit Link, öffentlich im Profil, mit Passwort, als ZIP, Diashow, RSS-Feed oder zum Einbetten. Von Hand hinzufügen, entfernen, umsortieren, mit anderen Konten füllen oder hineinladen geht nicht, dafür gibt es die Regel. Ein normales Album, das du mit niemandem teilst, lässt sich unter Bearbeiten in ein smartes umwandeln und zurück. Die von Hand hineingelegten Dateien verlassen dabei das Album, in deinem Konto bleiben sie. Über die API legt POST /api/albums mit { "title": "Urlaub", "rule": { "tag": "urlaub", "type": "image", "starred": false, "days": 30 } } ein smartes Album an.
Im Tag-Menü über den Dateien öffnet Tags verwalten die Liste aller Tags mit der Zahl der Dateien. Einen Tag umzubenennen ändert ihn bei allen Dateien auf einmal. Heißt der neue Name wie ein vorhandener Tag, werden beide zusammengeführt, ohne dass eine Datei den Tag doppelt trägt. Löschen entfernt den Tag von allen Dateien, die Dateien selbst bleiben. Smarte Alben und Regeln zum automatischen Teilen ziehen beim Umbenennen und Zusammenführen mit. Nach dem Löschen eines Tags finden sie nichts mehr, statt plötzlich alles zu zeigen. Über die API: PATCH /api/tags/:tag mit { "name": "neu" } und DELETE /api/tags/:tag.
Unter Statistik zeigt der Jahresrückblick, wie dein Jahr mit MoeShare aussah: wie viele Dateien du hochgeladen hast und wie groß sie zusammen sind, Aufrufe und Reaktionen, aktive Tage, die längste Serie an Tagen in Folge und den fleißigsten Tag. Diagramme zeigen die Uploads pro Monat, nach Wochentag und nach Uhrzeit, ein Balken die Mischung aus Bildern, Videos, Audio, Texten und anderen Dateien. Dazu kommen die meistgesehenen Dateien, die mit den meisten Reaktionen und dein erster Upload im Jahr. Frühere Jahre wählst du oben rechts, gezählt wird nach deutscher Zeit. Die Zahlen gibt es auch unter GET /api/files/year?year=2025.
Unter dem Rückblick weist ein Hinweis auf Bilder und Videos ohne Alternativtext hin. „Nachtragen“ geht sie der Reihe nach durch, Bild für Bild mit großer Vorschau, „Anzeigen“ filtert die Dateien im Dashboard.
Mit Strg+K, auf dem Mac mit ⌘K, öffnet sich im Dashboard, im Konto und im Admin-Bereich ein Suchfeld für alles Wichtige: Dateien hochladen, einen Text anlegen, einen Link kürzen, den Bildschirm aufnehmen, geplante Uploads zeigen, Tags verwalten, Alternativtexte nachtragen, den Jahresrückblick öffnen, zu jedem Bereich wechseln oder zwischen hellem und dunklem Design umschalten. Ab zwei Buchstaben findet es auch deine Dateien. Mit den Pfeiltasten wählst du aus, Enter führt aus. Auf dem Handy stehen die Befehle im Menü deines Kontos.
Bilder öffnest du im Dashboard über das Menü einer Datei oder in der großen Ansicht mit „Bild bearbeiten“. Der Editor schneidet zu, frei oder im Format 1:1, 4:3, 3:2, 16:9 oder 9:16, dreht und spiegelt. Dazu kommen Stift, Pfeil, Rahmen und Text in mehreren Farben und Stärken sowie Flächen, die etwas verpixeln oder abdecken, etwa Namen oder Adressen auf einem Screenshot. Jeder Schritt lässt sich mit Strg+Z rückgängig machen.
Gespeichert wird als Kopie oder anstelle des Originals. Beim Ersetzen bleibt der Link zur Ansichtsseite gleich, alte Direktlinks leiten auf die neue Fassung weiter und das Original bleibt als ältere Version erhalten. Bearbeiten lassen sich PNG-, JPEG- und WebP-Bilder.
Optimieren: Unter Admin › Einstellungen › Bilder schaltest du ein, dass MoeShare hochgeladene Bilder sparsamer speichert. Als Format stehen WebP (klappt überall), AVIF (noch kleiner, braucht mehr Rechenzeit) oder das ursprüngliche Format zur Wahl, dazu die Qualität (Standard 82) und eine größte Kantenlänge, über der Bilder verkleinert werden. Das gilt für JPEG, PNG, WebP, AVIF und TIFF. GIFs und Bilder mit mehreren Seiten bleiben, wie sie sind, PNG-Grafiken werden verlustfrei gespeichert. Wird ein Bild nicht kleiner, behält MoeShare das Original. Metadaten wie Kameradaten fallen beim Umrechnen weg. Mit „Original aufheben“ bleibt das unveränderte Bild als ältere Fassung erhalten, das klappt hier wie beim Wasserzeichen nur mit eingeschalteten Versionen. Jede Person kann das Optimieren unter Konto › Einstellungen für sich abschalten und es pro Upload in den Upload-Optionen oder mit X-Optimize ein- und ausschalten.
Wasserzeichen: Unter Gestalten › Wasserzeichen legt jede Person einen Text mit bis zu 80 Zeichen oder ein Logo fest (PNG mit transparentem Hintergrund oder SVG, höchstens 4 MB). Dazu kommen Position (neun Stellen oder über das ganze Bild verteilt), Größe, Deckkraft, Farbe und ein Schatten, der Text auf hellen und dunklen Bildern lesbar hält. Eine Vorschau zeigt das Ergebnis auf deinem letzten Bild oder einem Beispielbild. Das Wasserzeichen landet in jedem neuen Bild, schon hochgeladene bleiben unverändert. Mit „Original aufheben“ bleibt das Bild ohne Wasserzeichen als ältere Fassung erhalten, die nur du siehst. Einzelne Uploads nimmst du in den Upload-Optionen oder mit X-Watermark: false aus. Admins schalten Wasserzeichen unter Admin › Einstellungen › Bilder für alle ab. Für Text bringt MoeShare die Schrift Inter mit, eine installierte Schrift braucht der Server dafür nicht.
Ein Video öffnest du im Dashboard über das Menü der Datei oder in der großen Ansicht mit „Kürzen oder GIF machen“. Start und Ende legst du auf einer Zeitleiste fest, der Ausschnitt lässt sich vorher abspielen. Als MP4 speicherst du ihn mit oder ohne Ton als neue Datei oder als neue Fassung des Videos, dann bleibt der Link gleich. Als GIF wählst du 10 bis 25 Bilder pro Sekunde und eine Breite von 320 bis 800 Pixeln, ein GIF darf höchstens 30 Sekunden lang sein. FFmpeg rechnet auf dem Server im Hintergrund, den Fortschritt zeigt der Dialog. Das Ergebnis übernimmt die Inhaltswarnung des Videos und zählt zum Speicher wie jeder andere Upload.
Viele Browser zeigen Videos in HEVC, mit 10 Bit Farbtiefe oder in Containern wie MKV und AVI nur als schwarzes Bild. MoeShare erkennt solche Videos beim Hochladen und legt im Hintergrund eine Fassung in H.264 an, die überall läuft. Die Ansichtsseite spielt diese Fassung ab, heruntergeladen wird weiter das Original. Abschalten lässt sich das unter Admin › Einstellungen › Uploads › Videos für alle Browser.
Beim Hochladen misst MoeShare Seitenverhältnis und Drehung, damit hochkant gefilmte und anamorphe Videos ohne schwarze Ränder erscheinen, und nimmt als Vorschaubild eine Stelle, die nicht schwarz ist. Für Videos aus älteren Versionen gibt es unter Admin › System › Videos den Knopf „Alle Videos prüfen“, der Größen korrigiert, dunkle Vorschaubilder ersetzt und fehlende Fassungen anlegt. Auf der Kommandozeile geht das mit node cli.js videos.
Zu jedem Video lassen sich bis zu zehn Untertitel hochladen, im Dashboard über das Menü eines Videos › Untertitel. MoeShare nimmt SRT und WebVTT an und liefert sie als WebVTT aus. Pro Spur legst du Sprache und Namen fest und welche Spur eingeschaltet startet. Besucher schalten die Untertitel im Player der Ansichtsseite ein und aus.
Eine Inhaltswarnung legt sich über Dateien, die nicht alle sofort sehen sollen, etwa Spoiler oder drastische Bilder. Du setzt sie beim Hochladen in den Upload-Optionen, später im Menü einer Datei mit „Inhaltswarnung setzen“ oder in ShareX mit X-Warning, auf Wunsch mit einem kurzen Hinweis wie „Spoiler“ (bis 100 Zeichen).
Wer die Ansichtsseite öffnet, sieht zuerst den Hinweis über einer verschwommenen Fassung und entscheidet selbst, ob der Inhalt erscheint. In Discord, Telegram und Co. zeigt die Vorschau nur das verschwommene Bild mit der Warnung, ShareX kopiert statt des Direktlinks den Link zur Ansichtsseite. In Alben und auf Profilseiten bleiben solche Dateien verschwommen, bis jemand sie aufdeckt, im Dashboard sind sie in der Übersicht verschwommen.
Jede Datei kann eine Beschreibung mit bis zu 2000 Zeichen bekommen, Zeilenumbrüche bleiben erhalten. Sie steht auf der Ansichtsseite unter dem Titel, im Aufbau Magazin als Vorspann, und ersetzt in Link-Vorschauen bei Discord, Telegram und Co. die Beschreibung aus dem Embed Builder. Der Alternativtext beschreibt in bis zu 500 Zeichen, was auf einem Bild oder Video zu sehen ist. Screenreader lesen ihn vor, Suchmaschinen und Link-Vorschauen nutzen ihn (og:image:alt), und die Codes zum Einbetten übernehmen ihn.
Beides trägst du im Dashboard unter „Bearbeiten“ ein. ShareX und andere Programme schicken es beim Hochladen mit X-Description und X-Alt, die API als Felder description und alt. Die Suche im Dashboard findet Dateien auch über Beschreibung und Alternativtext. Bei Dateien mit Passwort, Aufruflimit oder Inhaltswarnung und bei verschlüsselten Dateien landet die Beschreibung nicht in der Link-Vorschau.
Für ältere Uploads hilft Alternativtexte nachtragen (unter Statistik oder in der Befehlspalette): Es zeigt jedes Bild und Video ohne Alternativtext groß an, du tippst, was zu sehen ist, und mit Strg+Enter geht es zum nächsten. Überspringen und später weitermachen ist jederzeit möglich. Der Filter Ohne Alternativtext zeigt dieselben Dateien im Dashboard, über die API GET /api/files?alt=missing.
Unter jeder Datei und auf Albumseiten können Besucher mit 👍 ❤️ 😂 😮 🔥 👏 reagieren, ohne Konto. Gespeichert werden nur die Summen pro Emoji. Damit niemand die Zahlen in die Höhe treibt, zählt jedes Emoji pro Besucher einmal am Tag. Dafür merkt sich MoeShare für 24 Stunden einen Fingerabdruck aus IP-Adresse und Browser, verschlüsselt mit einem Schlüssel, der jeden Tag wechselt, und nur im Arbeitsspeicher. IP-Adressen landen nirgends.
Dateien mit Aufruflimit und verschlüsselte Dateien zeigen keine Reaktionen, Dateien und Alben mit Passwort erst nach dem Entsperren, private Alben nie. Unter Gestalten › Vorschauseite blendest du die Reaktionen für deine Seiten und Alben aus, Admins schalten sie unter Admin › Einstellungen › Funktionen › Teilen und Reaktionen für alle ab.
Im Dashboard steht die Zahl der Reaktionen auf jeder Kachel und in den Details, die Sortierung Meiste Reaktionen zeigt die beliebtesten Dateien zuerst und die Statistik listet sie mit der Gesamtzahl. Unter Konto › Einstellungen schaltest du Hinweise auf neue Reaktionen ein, per E-Mail oder Push. Damit nicht jedes Emoji einzeln klingelt, sammelt MoeShare die Reaktionen zehn Minuten lang und schickt dann eine Nachricht für alle Dateien und Alben zusammen. Eigene Reaktionen lösen keinen Hinweis aus.
Bilder, Videos, Audio, Alben und deine Profilkarte lassen sich in andere Websites einbauen, etwa in einen Blog, ein Forum oder eine Wiki-Seite. Im Dashboard öffnet „Einbetten und Codes“ im Menü einer Datei oder unter „Teilen“ in der großen Ansicht einen Dialog mit fertigen Codes, ein Album hat dafür den Knopf „Einbetten“, die Profilseite unter Gestalten › Profilseite ebenso. Besucher finden denselben Knopf auf der Ansichtsseite.
- Einbetten liefert einen
<iframe>mit Breite und Farben nach Wahl (hell, dunkel oder wie das Gerät). Darin steht die Datei mit Player, darunter ein Link zur Ansichtsseite. Eine Vorschau zeigt, wie es aussieht. - Markdown, BBCode und HTML binden ein Bild direkt ein, mit dem Alternativtext und einem Link zur Ansichtsseite. Link ist die Adresse der Ansichtsseite.
Die Profilkarte unter /frame/u/:benutzer zeigt Profilbild, Namen, Beschreibung und bis zu sechs Links mit ihren Symbolen, gedacht für eine Seitenleiste oder eine „Über mich“-Seite.
Seiten, die oEmbed verstehen, etwa WordPress, Ghost, Notion oder Discourse, brauchen gar keinen Code: Der Link zur Ansichtsseite, zu einem Album oder einem Profil reicht, den Rest holen sie sich unter /oembed?url=…. Bilder kommen dabei als Foto, mit eingeschaltetem Hotlink-Schutz und für andere Dateien als iframe. Autor und Seitenname übernimmt MoeShare aus dem Embed Builder.
Die eingebettete Seite unter /frame/:dateiname bzw. /frame/a/:code lädt keine Skripte und darf auf jeder Website in einem iframe stehen. Sie zählt als Aufruf in der Statistik. Dateien mit Passwort oder Aufruflimit erscheinen nur als Karte mit einem Link, ohne dass dabei ein Aufruf verbraucht wird, verschlüsselte Dateien und Inhaltswarnungen ebenso. Private Alben lassen sich nicht einbetten. Weil die Bilder aus dem iframe von deinem Server kommen, funktioniert Einbetten auch mit eingeschaltetem Hotlink-Schutz. Mit einer eigenen Domain steht sie auch dort bereit. Unter Gestalten › Vorschauseite blendest du den Knopf auf deinen Seiten aus, Admins schalten das Einbetten unter Admin › Einstellungen › Funktionen › Teilen und Reaktionen ab.
Ist der E-Mail-Versand eingerichtet, schickt „Per E-Mail senden“ im Menü einer Datei, unter „Teilen“ in der großen Ansicht oder bei einem Album den Link an bis zu fünf Adressen auf einmal, mit einer persönlichen Nachricht von bis zu 500 Zeichen. Die E-Mail kommt vom Absender des Servers, trägt deinen Namen und einen Knopf zum Öffnen. Hast du eine bestätigte E-Mail-Adresse, gehen Antworten direkt an dich. Bei Dateien mit Passwort steht in der E-Mail, dass sie geschützt ist, das Passwort selbst nie. Verschlüsselte Dateien und private Alben lassen sich so nicht teilen.
Damit niemand den Server zum Verschicken von Werbung nutzt, sind es höchstens 30 E-Mails pro Stunde und Konto. Jede Sendung steht im Aktivitätsprotokoll. Admins schalten die Funktion unter Admin › Einstellungen › Funktionen › Teilen und Reaktionen ab. Über die API: POST /api/files/:id/email bzw. POST /api/albums/:id/email mit { "to": ["a@example.org"], "message": "Schau mal" }.
Unter Gestalten › Vorschauseite baut jede Person ihr eigenes Design für die Seiten ihrer Dateien. Es gilt auch für Alben und die Profilseite. Eine Live-Vorschau zeigt jede Änderung sofort, wahlweise mit einer eigenen Datei und in Handy- oder PC-Größe.
| Aufbau | So sieht es aus |
|---|---|
| Klassisch | Leuchtender Hintergrund aus den Farben des Bildes, darunter eine Karte mit allen Angaben |
| Schlicht | Nur die Datei auf ruhiger Fläche, die Angaben in einer schmalen Zeile |
| Bühne | Die Datei füllt den Bildschirm, die Knöpfe schweben darüber, immer dunkel |
| Seitlich | Datei links, Angaben und Knöpfe in einer eigenen Spalte |
| Sofortbild | Die Datei liegt wie ein Polaroid leicht schräg auf dem Tisch |
| Magazin | Großer Titel wie in einer Zeitschrift, die Datei darunter in voller Breite |
Dazu kommen Akzentfarbe (aus der Datei, die Farbe der Seite oder eine eigene), hell, dunkel oder nach Wahl der Besucher, vier Hintergründe, vier Schriften und drei Eckenformen. Titel, Beschreibung, Uploader, Datum, Größe, Aufrufe, Reaktionen und die einzelnen Knöpfe, auch „Einbetten“, lassen sich ausblenden. Eine kurze Notiz und ein eigener Knopf, etwa zu deinem Portfolio, stehen unter jeder Datei.
Admins legen unter Gestalten › Vorschauseite › Standard fest, wie die Seiten aussehen, solange jemand kein eigenes Design gebaut hat. Dort schalten sie eigene Designs ab, dann gilt für alle der Standard, und bestimmen, wer eigenes CSS schreiben darf: niemand (Standard), nur Admins oder alle. MoeShare beschränkt das CSS auf die eigenen Seiten, lädt keine fremden Dateien (url() und @import gehen nicht) und erlaubt nur @media, @supports und @container. Klassen wie .ms-title, .ms-media, .ms-actions und .ms-meta stehen im Editor.
Der Embed Builder für die Vorschau in Discord liegt jetzt ebenfalls unter Gestalten, im Reiter Embed.
Unter Gestalten › Profilseite schaltet jede Person ihre öffentliche Seite unter /u/<benutzername> ein: mit Anzeigename, kurzer Beschreibung, Links, den öffentlichen Alben und ausgewählten Dateien. Welche Dateien dort erscheinen, legst du pro Datei mit „Im Profil zeigen“ fest. Dateien mit Passwort oder begrenzten Abrufen tauchen dort nie auf. Die Profilseite übernimmt das Design der Vorschauseiten und ist die Startseite einer eigenen Domain.
Eine Profilseite hat bis zu 30 Einträge: Links und Überschriften, die sie in Abschnitte teilen. Die Reihenfolge änderst du mit den Pfeilen, „Ausblenden“ nimmt einen Link von der Seite, ohne ihn zu löschen. Mit „Sichtbar ab“ und „Sichtbar bis“ erscheint ein Link nur für eine bestimmte Zeit, etwa für eine Aktion oder einen Livestream. Neben Adressen mit https:// gehen E-Mail-Adressen und Telefonnummern, MoeShare macht daraus mailto:- und tel:-Links. Fehlt https://, ergänzt MoeShare es.
Jeder Link bekommt ein Symbol:
- Automatisch (Standard): MoeShare erkennt über 80 Dienste an der Adresse, etwa Discord, YouTube, Twitch, GitHub, Instagram, Spotify oder Steam, dazu E-Mail, Telefon, Feeds und PDFs. Für alles andere gibt es eine Weltkugel.
- Vorgefertigt: 50 allgemeine Symbole wie Shop, Blog, Podcast, Termine oder Unterstützen und die Symbole der Dienste zum Aussuchen, mit Suche.
- Emoji: aus einer Auswahl oder ein beliebiges.
- Eigene Symbole: ein Bild hochladen oder aus den eigenen Uploads nehmen und quadratisch zuschneiden. MoeShare speichert es als WebP mit 128 × 128 Pixeln in der Datenbank, so steckt es in jeder Sicherung. Bis zu 40 eigene Symbole pro Konto, jedes lässt sich für beliebig viele Links nutzen.
Die Symbole der Dienste stammen von Simple Icons, die Marken gehören ihren Inhabern.
Ein Link erscheint als Knopf mit Beschriftung oder als runder Knopf in einer Symbolleiste unter der Beschreibung, praktisch für soziale Netzwerke. Einzelne Knöpfe lassen sich hervorheben. Unter Darstellung wählst du zwischen einer Liste mit großen Knöpfen untereinander, wie bei Link-in-Bio-Seiten, und einer kompakten Reihe. Links tragen rel="me", so bestätigt etwa Mastodon, dass die Profilseite dir gehört. Für eigenes CSS gibt es die Klassen .ms-links, .ms-link, .ms-link-highlight, .ms-link-heading und .ms-link-icons.
Im Editor steht, wie oft die Profilseite in den letzten 30 Tagen aufgerufen wurde, und an jedem Link, wie oft er geklickt wurde. Wie bei den anderen Statistiken bleiben nur Summen pro Tag, ohne IP-Adressen und Cookies, eigene Aufrufe und Klicks zählen nicht mit. Die Links zeigen dabei weiter direkt auf ihr Ziel, gezählt wird beim Klick nebenher. Ist die Statistik unter Admin › Einstellungen › Funktionen abgeschaltet, zählt MoeShare auch hier nichts.
Mit Kontakt speichern anbieten steht auf der Profilseite ein Knopf, der eine vCard herunterlädt: Name, Profilbild, Beschreibung, die Links samt Beschriftung und die E-Mail-Adressen und Telefonnummern aus den Links. So landet das Profil mit einem Tipp im Adressbuch, etwa nach dem Scannen des QR-Codes.
Unter Admin › Einstellungen › Funktionen lassen sich Profilseiten und eigene Symbole für alle abschalten. Vorgefertigte Symbole und Emojis gehen immer.
Ein Klick auf das Bild oben unter Konto öffnet den Editor: ein Bild auswählen, hineinziehen oder aus den eigenen Uploads nehmen, dann den runden Ausschnitt verschieben und zoomen. MoeShare speichert das Ergebnis als WebP mit 256 × 256 Pixeln in der Datenbank, so steckt es in jeder Sicherung. Bewegte GIFs und animierte WebP-Bilder bleiben bewegt. Das Bild erscheint auf der Profilseite samt ihrer Linkvorschau, auf den Vorschauseiten deiner Dateien, in Alben und überall in der Oberfläche. Erlaubt sind Bilder bis 15 MB und ab 32 Pixeln Kantenlänge.
Unter Admin › Einstellungen › Funktionen schaltest du Profilbilder ab oder lässt nur unbewegte zu. Ein unpassendes Bild entfernen Admins unter Admin › Benutzer.
Auf jeder Albumseite startet Diashow die Bilder und Videos im Vollbild. Bilder wechseln alle 3, 5 oder 10 Sekunden, Videos laufen bis zum Ende. Die Leertaste hält an, die Pfeiltasten und Wischen blättern, F schaltet das Vollbild um. Dateien mit Inhaltswarnung zeigt die Diashow erst nach einem Klick und wartet so lange.
Profile und Alben haben einen Atom-Feed für jeden Feed-Reader: /u/<name>/feed.xml mit den Dateien und Alben, die auf dem Profil stehen, und /a/<code>/feed.xml mit den Dateien eines Albums. Auf eigenen Domains liegt der Feed des Profils unter /feed.xml. Alben mit Passwort und private Alben haben keinen Feed, Bilder mit Inhaltswarnung erscheinen im Feed ohne Vorschau.
Mit einer eigenen Domain zeigt MoeShare Dateien, Alben, Kurzlinks und die Profilseite einer Person zusätzlich unter einer Adresse, die ihr gehört, etwa bilder.deinname.de. Anders als die Domains des Servers gehört so eine Domain genau einem Konto, und unter ihr ist nur dessen Inhalt erreichbar.
Ein Admin schaltet das unter Admin › Einstellungen › Eigene Domains ein. Dort stehen auch die Höchstzahl pro Konto (Standard 3), der Hostname, auf den die Domains zeigen sollen (ohne Angabe die Hauptadresse) und eine Liste aller verbundenen Domains, aus der Admins jede wieder entfernen können.
So verbindet jemand eine Domain:
- Unter Konto › Domains die Domain eintragen.
- Beim DNS-Anbieter den angezeigten TXT-Eintrag anlegen, etwa
_bilder-kiste.bilder.deinname.demit dem Wertbilder-kiste-verify=…. Der Name richtet sich nach dem Namen des Servers, siehe Eigener Name. Der Eintrag zeigt, dass einem die Domain gehört. - Die Domain per CNAME auf den Server zeigen lassen. Für eine Domain ohne Subdomain nimmst du A- und AAAA-Einträge mit den Adressen des Servers.
- Impressum und Datenschutzerklärung eintragen.
Unter der eigenen Domain sind Links kürzer: Statt bilder.deinname.de/view/JrinQR99 reicht bilder.deinname.de/JrinQR99, neue Links mit der Domain sehen von selbst so aus. Eigene Adressen klappen dort genauso, etwa bilder.deinname.de/urlaub. Dateien anderer Konten sind unter der Domain nicht erreichbar.
MoeShare prüft neue Domains in den ersten sieben Tagen alle paar Minuten von selbst und verbindet sie, sobald der TXT-Eintrag stimmt. Mit „Jetzt prüfen“ geht es sofort, dabei zeigt MoeShare auch, ob die Domain schon auf den Server zeigt und über HTTPS erreichbar ist. Mit „Als Standard für neue Links“ nutzen neue Uploads die Domain, ShareX wählt sie auch über X-Domain. Anmeldung, Dashboard und Verwaltung bleiben auf der Hauptadresse, wer unter der eigenen Domain dorthin will, wird weitergeleitet.
Für HTTPS braucht der Reverse-Proxy Zertifikate auf Abruf. Die Caddyfile aus dem Repository bringt das mit, siehe Hinter einem Reverse-Proxy. Caddy fragt vor jedem Zertifikat unter /api/domains/tls nach, ob die Domain zu einem Konto gehört, für fremde Domains gibt es keins. Prüft MoeShare das DNS über einen bestimmten Server, etwa im eigenen Netz, setzt du ihn mit DNS_SERVERS.
Wer unter einer eigenen Domain Inhalte zeigt, braucht dort ein eigenes Impressum und eine eigene Datenschutzerklärung. Ab Version 3.4.0 verlangt MoeShare beides für jede eigene Domain. Unter Konto › Domains › Impressum und Datenschutz eintragen gibt es drei Wege:
- Vorlage ausfüllen: Name oder Firma, Anschrift, E-Mail und bei Bedarf Vertretung, Registereintrag, Umsatzsteuer-ID und die verantwortliche Person für redaktionelle Inhalte. Daraus entsteht ein Impressum nach § 5 DDG und eine Datenschutzerklärung, die beschreibt, was der Server technisch verarbeitet. Für den Datenschutz trägst du nur ein, was sich vom Impressum unterscheidet, etwa eine Datenschutzbeauftragte Person oder die zuständige Aufsichtsbehörde.
- Eigener Text: etwa aus einem Generator oder von deiner Kanzlei. Zeilen, die mit
##beginnen, werden Überschriften. - Link: Die Seiten unter der Domain leiten auf dein eigenes Impressum weiter.
Die Vorschau zeigt beide Seiten auf Deutsch und Englisch, Besucher sehen die Sprache, die ihr Browser bevorzugt. Die Seiten stehen unter /impressum und /datenschutz der Domain, die Fußzeile verlinkt sie. Die Vorlage ersetzt keine Rechtsberatung.
Solange etwas fehlt, ist die Domain pausiert: Links über sie leiten auf die Hauptadresse um, und das Dashboard zeigt einen Hinweis. Domains, die vor dem Update schon verbunden waren, haben 14 Tage Zeit. Admins können die Pflicht unter Admin › Einstellungen › Eigene Domains abschalten, dann verweisen Domains ohne eigene Angaben auf das Impressum des Servers.
Auf jeder öffentlichen Seite steht unten „Melden“. Besucher wählen einen Grund, etwa Urheberrecht, persönliche Daten oder Spam, und können eine Beschreibung und eine Kontaktadresse angeben. Die Meldungen landen bei den Admins unter Admin › Meldungen und, wenn E-Mail eingerichtet ist, auf Wunsch auch im Postfach. Gleiche Meldungen fasst MoeShare zusammen.
Für jede Meldung gibt es diese Möglichkeiten: verwerfen, den Inhalt sperren, ihn löschen oder das Konto sperren. Gesperrte Dateien, Alben, Kurzlinks und Profile antworten mit dem Status 451 und einem Hinweis. Nur die Besitzer und die Admins sehen sie noch, samt Sperre und Grund. Eine Sperre lässt sich jederzeit aufheben. Unter Admin › Einstellungen › Funktionen schaltest du das Melden ab.
Unter Admin › Einstellungen › E-Mail trägst du einen SMTP-Server ein, etwa den deines Mail-Anbieters, und schickst eine Testmail. Danach kann MoeShare:
- Passwort vergessen: Ein Link zum Zurücksetzen geht an die bestätigte Adresse. Er gilt eine Stunde und nur einmal. Nach dem Zurücksetzen sind alle Sitzungen des Kontos abgemeldet. Ist die Anmeldung mit Passwort abgeschaltet, entfällt das.
- Anmeldelinks auf Anfrage an die bestätigte Adresse schicken, siehe Einmal-Links.
- Einladungen direkt an eine E-Mail-Adresse schicken.
- Hinweise zum Konto verschicken, etwa wenn sich das Passwort oder die Zwei-Faktor-Anmeldung ändert, ein Passkey dazukommt oder sich jemand mit einem Einmal-Link anmeldet.
- Admins benachrichtigen bei neuen Meldungen, neuen Konten und Anfragen für Einmal-Links.
- Hinweise auf Reaktionen und die tägliche Erinnerung An diesem Tag verschicken, wenn die Person sie einschaltet.
- Dateien und Alben per E-Mail teilen.
Jede Person trägt ihre Adresse unter Konto › Einstellungen ein und bestätigt sie über einen Link. Dort wählt sie auch, welche Hinweise sie per Mail bekommt. E-Mails kommen in der Sprache der Empfänger. Ohne E-Mail-Server kommen die wichtigsten Hinweise auf Wunsch als Push-Benachrichtigung.
Hinweise kommen auf Wunsch direkt aufs Handy oder den Rechner, auch wenn MoeShare gerade nicht offen ist. Einen E-Mail-Server braucht es dafür nicht, nur HTTPS. Unter Konto › Einstellungen › Push-Benachrichtigungen schaltet jede Person Push für das Gerät ein, an dem sie gerade sitzt, und wählt, was dort ankommt:
- Sicherheitshinweise: eine Anmeldung auf einem neuen Gerät und Änderungen an Passwort, Zwei-Faktor-Anmeldung oder Passkeys
- Uploads über Datei-Anfragen, sofern bei der Anfrage „Mich bei neuen Dateien benachrichtigen“ eingeschaltet ist
- Reaktionen auf deine Uploads, gesammelt für alle Dateien und Alben
- An diesem Tag: morgens, wenn du am heutigen Tag in früheren Jahren etwas hochgeladen hast
- für Admins außerdem neue Meldungen, neue Benutzer und Systemmeldungen wie ablaufende Zertifikate, Probleme mit Caddy oder eine neue Version
Ein Tipp auf den Hinweis öffnet die passende Seite. „Test senden“ prüft die Zustellung, und Geräte, an denen du gerade nicht bist, schaltest du in derselben Liste ab. Auf iPhone und iPad klappt Push erst, wenn MoeShare als App auf dem Home-Bildschirm liegt, ab iOS 16.4. Pro Konto merkt sich MoeShare bis zu 20 Geräte, kommt ein weiteres dazu, fällt das am längsten unbenutzte heraus.
Zugestellt wird über den Push-Dienst des Browsers, also über Google, Mozilla, Apple oder Microsoft, andere Adressen nimmt MoeShare nicht an. Die Nachrichten sind verschlüsselt (RFC 8291), der Push-Dienst sieht nur, dass eine kommt. Die Schlüssel des Servers (VAPID) erzeugt MoeShare selbst und speichert sie verschlüsselt. Für deine Datenschutzerklärung: Pro Gerät speichert MoeShare die Adresse beim Push-Dienst, die Schlüssel des Browsers und einen Gerätenamen wie „Chrome auf Android“. Das bleibt, bis Push dort ausgeschaltet wird, der Push-Dienst die Adresse aufgibt oder zehn Zustellungen nacheinander scheitern.
Unter Admin › Einstellungen › Allgemein › App schaltest du Push für alle ab.
Unter Admin › Einstellungen › Benachrichtigungen legst du bis zu 20 Ziele an. Jedes Ziel bekommt eine eigene Auswahl an Ereignissen: Uploads, Löschungen, Benutzer, Sicherheit, Verarbeitung, Meldungen, Systemfehler, Virenfunde, geteilte Alben und Importe. „Testen“ schickt sofort eine Nachricht, und die Liste zeigt, ob die letzte Zustellung geklappt hat. Adressen und Tokens speichert MoeShare verschlüsselt. Ein Discord-Webhook aus einer älteren Version wird beim Update als erstes Ziel übernommen.
| Dienst | Was du brauchst |
|---|---|
| Discord | Webhook-Adresse aus den Kanaleinstellungen › Integrationen › Webhooks |
| Slack | Adresse eines Incoming Webhooks (https://hooks.slack.com/…) |
| Matrix | Adresse des Servers, den Raum (!abc123:matrix.org oder #name:matrix.org) und das Zugangstoken eines Kontos, das im Raum ist |
| Telegram | Token eines Bots von @BotFather und die Chat-ID oder @kanalname, der Bot muss im Chat sein |
| ntfy | Thema, dazu bei Bedarf ein eigener Server, ein Zugangstoken und die Priorität |
| Eigener Webhook | Eine Adresse, die JSON per POST annimmt, optional ein Schlüssel für die Signatur |
Der eigene Webhook bekommt jedes Ereignis so:
{
"event": "upload",
"kind": "success",
"title": "Neue Datei hochgeladen",
"text": "Dateiname: aB3dE9.png\nURL: https://share.example.com/view/aB3dE9\nBenutzername: max\nGröße: 1,2 MB",
"markdown": "Dateiname: **aB3dE9.png**\nURL: **https://share.example.com/view/aB3dE9**\nBenutzername: **max**\nGröße: **1,2 MB**",
"site": { "title": "MoeShare", "url": "https://share.example.com" },
"at": "2026-10-23T08:15:02.418Z"
}Der Header X-Webhook-Event nennt das Ereignis. Mit Schlüssel steht in X-Webhook-Signature der Wert sha256=…, die HMAC-SHA256 des unveränderten Bodys mit dem Schlüssel. Ziele aus Versionen vor 3.4.0 bekommen zusätzlich die alten Header X-MoeShare-Event und X-MoeShare-Signature, bis du das in der Liste abschaltest. So prüfst du die Signatur in Node.js, rawBody ist dabei der Body, so wie er ankam:
const signature = req.get('X-Webhook-Signature') || '';
const expected = `sha256=${crypto.createHmac('sha256', SECRET).update(rawBody).digest('hex')}`;
const valid = signature.length === expected.length && crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));Die Texte kommen in der Sprache des Servers. kind ist error, wenn etwas schiefging, etwa bei Systemfehlern oder Virenfunden.
Mit ClamAV prüft MoeShare jede Datei, bevor sie gespeichert wird: Uploads aus dem Browser, über ShareX und die API, neue Fassungen und Dateien per Link. Findet ClamAV Schadsoftware, wird die Datei sofort gelöscht, der Upload bekommt den Status 422 mit dem Namen des Funds, das Aktivitätsprotokoll des Kontos vermerkt ihn und die Benachrichtigung „Virenfunde“ geht raus. Dateien aus einem Import prüft MoeShare nicht.
MoeShare spricht mit einem laufenden ClamAV-Daemon (clamd) über TCP oder einen Unix-Socket. Mit Docker startet die Ergänzung docker/clamav.yml ihn als eigenen Container:
mkdir -p docker
curl -o docker/clamav.yml https://raw.githubusercontent.com/MaximilianGT500/moeshare/main/docker/clamav.yml
echo "COMPOSE_FILE=docker-compose.yml:docker/clamav.yml" >> .env
docker compose up -dNutzt du schon PostgreSQL oder MariaDB, hängst du die Datei an, etwa COMPOSE_FILE=docker-compose.yml:docker/postgres.yml:docker/clamav.yml. Beim ersten Start lädt ClamAV seine Signaturen, das dauert ein paar Minuten. Laut ClamAV braucht der Container mindestens 3 GB Arbeitsspeicher, besser 4 GB. Ohne Docker installierst du ClamAV über die Paketverwaltung, unter Debian und Ubuntu etwa mit apt install clamav-daemon, und trägst den Socket /run/clamav/clamd.ctl ein.
Unter Admin › Einstellungen › Virenscan trägst du Host und Port ein (im Docker-Stack clamav und 3310) oder den Socket und prüfst die Verbindung mit „Testen“. Dabei geht die harmlose EICAR-Testsignatur an ClamAV, die es erkennen muss. Danach schaltest du „Uploads prüfen“ ein. Außerdem legst du fest:
- Größte geprüfte Datei: Größere Dateien nimmt MoeShare ungeprüft an (Standard 25 MB). Soll ClamAV mehr prüfen, erhöhst du dort auch
StreamMaxLengthin derclamd.conf. - Wenn ClamAV nicht antwortet: den Upload abweisen (Standard) oder ungeprüft annehmen.
Unter Admin › Einstellungen › Uploads › Gesperrte Dateitypen trägst du Endungen ein, die MoeShare nicht annimmt, etwa .exe oder .bat. Empfohlene Liste übernimmt mit einem Klick gängige Programme und Skripte für Windows, Java und Android. Mit Programme am Inhalt erkennen lehnt MoeShare Programme für Windows, Linux und macOS auch dann ab, wenn sie umbenannt wurden.
Die Sperre gilt für alle Upload-Wege, auch für Datei-Anfragen, Links und die Discord-App. Admins dürfen solche Dateien weiter hochladen, außer über Datei-Anfragen, dort laden ja Gäste hoch. Große Uploads lehnt MoeShare schon beim Start ab, im Dashboard sogar, bevor überhaupt etwas übertragen wird.
Mit dem Hotlink-Schutz binden andere Seiten deine Bilder, Videos und Dateien nicht mehr direkt von deinem Server ein und verbrauchen so keinen Traffic auf deine Kosten. Du schaltest ihn unter Admin › Einstellungen › Uploads › Hotlink-Schutz ein. Er gilt für die Direktlinks unter /uploads/…, Ansichtsseiten, Alben, Profile und der Download-Link bleiben für alle erreichbar. Wer eine Datei trotzdem auf einer anderen Seite zeigen will, nimmt den Code zum Einbetten.
- Deine eigenen Seiten, alle Domains der Instanz und die eigenen Domains der Konten dürfen immer einbinden. Weitere Seiten trägst du unter „Erlaubte Seiten“ ein, mit
*.example.orggehören alle Subdomains dazu. - Link-Vorschauen von Discord, Telegram, WhatsApp, Slack, Mastodon und anderen Diensten funktionieren weiter.
- Wer auf einer fremden Seite einen Direktlink anklickt, landet auf der Ansichtsseite. Eingebundene Bilder und Videos bleiben dort leer.
- Angemeldet siehst du deine eigenen Dateien überall.
- Apps, Feed-Reader und manche Browser verraten nicht, woher sie kommen. Solche Abrufe sind erlaubt, solange „Abrufe ohne Herkunft erlauben“ eingeschaltet ist.
MoeShare erkennt die Herkunft an den Headern Sec-Fetch-Site und Referer. Das hält Seiten ab, die deine Dateien einbinden, aber niemanden, der eine Datei gezielt mit gefälschten Headern abruft. Liegt ein CDN mit Cache davor, beachtet es den Header Vary: Referer oft nicht. Nimm /uploads/ dann vom Cache aus, sonst liefert das CDN zwischengespeicherte Dateien auch an fremde Seiten.
Unter Konto › Konto › Deine Daten lädt jede Person ein ZIP-Archiv mit allem herunter, was MoeShare über sie gespeichert hat: alle Dateien, ältere Fassungen und den Papierkorb, dazu account.json (Konto, Einstellungen, Profil, Design, Domains, Anmeldeverfahren), files.json (mit Tags, Alben, Schutz, Versionen, Beschreibung, Alternativtext und Favoriten), albums.json, links.json und activity.json, das Profilbild und die eigenen Symbole für Links sowie eine LIESMICH.txt, die den Inhalt erklärt. „Nur die Angaben“ lässt die Dateien weg. Passwörter, Tokens und andere Geheimnisse stehen nicht im Export. Vor dem Download fragt MoeShare noch einmal nach Passwort oder Passkey. Unter Admin › Einstellungen › Funktionen schaltest du den Export ab.
Von Zipline 3 und 4, XBackBone und Chibisafe übernimmt MoeShare Konten, Dateien, Texte, Alben bzw. Ordner und Kurzlinks. Die alte Installation bleibt dabei unverändert, MoeShare liest ihre Datenbank nur und kopiert die Dateien.
| Uploader | Datenbank | Ordner mit den Dateien |
|---|---|---|
| Zipline | PostgreSQL, die Adresse aus DATABASE_URL |
der Ordner aus DATASOURCE_LOCAL_DIRECTORY, meist uploads |
| XBackBone | Pfad zur SQLite-Datei oder mysql://benutzer:passwort@host/xbackbone |
der Ordner storage |
| Chibisafe | Pfad zur database.sqlite |
der Ordner uploads |
Unter Admin › Einstellungen › Import wählst du den alten Uploader, trägst Datenbank und Ordner ein und klickst auf „Prüfen“. MoeShare zeigt dann, wie viele Konten, Dateien, Alben, Texte und Kurzlinks es findet und was mit jedem Konto passiert. Gleichnamige Konten führt MoeShare auf Wunsch mit bestehenden zusammen, sonst bekommen sie einen neuen Namen. Admins bleiben auf Wunsch Admins, Dateien ohne Besitzer landen in deinem Konto oder bleiben weg. Nach „Import starten“ arbeitet MoeShare im Hintergrund und zeigt den Fortschritt, am Ende steht eine Übersicht mit allem, was übernommen wurde.
Passwörter aus bcrypt übernimmt MoeShare direkt, Argon2 ab Node.js 24.7 (im Docker-Image immer). Alle anderen Konten bekommen ein vorläufiges Passwort, das nach dem Import einmal angezeigt wird und beim ersten Anmelden geändert werden muss. Alte Links leiten danach weiter, etwa /u/… und /r/… von Zipline, /…/raw von XBackBone oder Kurzlinks von Chibisafe, sofern die alte Domain auf MoeShare zeigt, zum Beispiel als weitere Domain. Ein zweiter Durchlauf überspringt alles, was schon übernommen wurde.
Mit Docker muss MoeShare den Ordner und eine SQLite-Datenbank im Container sehen. Ergänze dafür in der docker-compose.yml bei moeshare unter volumes eine schreibgeschützte Zeile wie - /srv/zipline/uploads:/import/dateien:ro und gib im Formular den Pfad im Container an, hier /import/dateien. Eine Datenbank auf einem Server muss MoeShare über das Netzwerk erreichen.
Auf der Kommandozeile geht es ebenso, mit --probe nur als Probelauf:
node cli.js import zipline --db postgres://zipline:passwort@localhost:5432/zipline --files /srv/zipline/uploads --probeMoeShare speichert Konten, Einstellungen und Dateiinfos in einer Datenbank. Ohne weitere Angabe ist das eine SQLite-Datei unter db/datenbank.sqlite, die für die meisten Server reicht und keine Einrichtung braucht. Läuft bei dir schon PostgreSQL oder MySQL bzw. MariaDB, nimmt MoeShare auch die. Getestet wird mit PostgreSQL 16 und 18 sowie MariaDB 10.11.
Welche Datenbank genutzt wird, legst du auf einem von drei Wegen fest:
- Im Installationsassistenten im Schritt „Datenbank“, mit Verbindungstest. Die Adresse landet in
db/database.json. - Mit der Umgebungsvariable
DATABASE_URL. Sie hat Vorrang vor allem anderen. - Mit
copy-db … --useauf der Kommandozeile, siehe unten.
| Datenbank | Adresse |
|---|---|
| SQLite | sqlite:db/datenbank.sqlite (Pfad relativ zum Projektordner oder absolut) |
| PostgreSQL | postgres://benutzer:passwort@server:5432/datenbank |
| MySQL oder MariaDB | mysql://benutzer:passwort@server:3306/datenbank |
Für eine verschlüsselte Verbindung hängst du ?sslmode=require an, mit ?sslmode=verify-full prüft MoeShare zusätzlich das Zertifikat. Sonderzeichen im Passwort müssen in der Adresse kodiert sein, aus # wird zum Beispiel %23. Die Datenbank muss es schon geben, die Tabellen legt MoeShare beim Start selbst an. Der Benutzer braucht dafür das Recht, Tabellen zu erstellen.
Bestehende Daten ziehen mit copy-db um. Beende MoeShare vorher, damit beim Kopieren nichts verloren geht. Die Ziel-Datenbank muss leer sein:
node cli.js copy-db postgres://moeshare:passwort@localhost:5432/moeshare --useMoeShare kopiert alle Tabellen, prüft danach die Anzahl der Einträge und nutzt mit --use ab dem nächsten Start die neue Datenbank. Ohne --use bleibt alles beim Alten und du stellst selbst über DATABASE_URL um. Die alte Datenbank bleibt in jedem Fall unverändert liegen. node cli.js db zeigt, welche Datenbank gerade genutzt wird und wie viele Einträge in jeder Tabelle stehen.
Mit Docker und einer der Ergänzungen aus dem Ordner docker/ sieht der Umzug von SQLite nach PostgreSQL so aus:
docker compose stop moeshare
docker compose -f docker-compose.yml -f docker/postgres.yml up -d postgres
docker compose -f docker-compose.yml run --rm moeshare moeshare copy-db "postgres://moeshare:DEIN_PASSWORT@postgres:5432/moeshare"
echo "COMPOSE_FILE=docker-compose.yml:docker/postgres.yml" >> .env
docker compose up -dStatt im Ordner uploads/ kann MoeShare Dateien in einem S3-kompatiblen Speicher ablegen, zum Beispiel bei AWS, Cloudflare R2, Backblaze B2, Wasabi oder in einem eigenen MinIO. Unter Admin › Einstellungen › Speicherort trägst du Endpoint, Region, Bucket und Zugangsdaten ein, prüfst sie mit „Verbindung testen“ und stellst den Speicherort für neue Uploads auf S3 um.
- Endpoint: bei AWS leer lassen, bei R2 die Adresse aus dem Cloudflare-Dashboard, bei MinIO die deines Servers. Selbst betriebene Dienste ohne Bucket-Subdomains brauchen „Pfad-Adressen“.
- Ordner im Bucket: optional, so kann sich MoeShare einen Bucket mit anderem teilen.
- Auslieferung: „Über den Server“ hält den Bucket privat, alles läuft durch MoeShare. „Direkt aus S3“ leitet Besucher auf eine kurzlebige, signierte Adresse um und entlastet den Server.
Vorschaubilder entstehen weiterhin auf dem Server, danach wandert die Datei in den Bucket, ältere Fassungen gehen mit. Vorhandene Dateien verschiebst du auf derselben Seite mit „Alles nach S3 verschieben“ und zurück mit „Alles auf den Server holen“, alle Links bleiben dabei gleich. Auf der Kommandozeile geht das mit node cli.js storage s3 bzw. node cli.js storage lokal.
Im Bucket liegt jede Datei für sich. Gleiche Dateien teilen sich dort keinen Platz wie im Ordner uploads/, das Dashboard zeigt Duplikate aber weiter an. Zum Kürzen eines Videos holt MoeShare es kurz auf den Server und löscht die Kopie danach wieder.
Alle Einstellungen stehen in der Datenbank und werden unter Admin › Einstellungen geändert: Allgemein, Uploads, Bilder, Funktionen, Virenscan, Eigene Domains, Speicherort, Sicherungen, E-Mail, Anmeldung, Anmeldedienste, Rechtliches und Links, Benachrichtigungen, Import und System. Änderungen gelten sofort, auch für alle Prozesse im PM2-Cluster.
Unter Konto › Einstellungen legt jede Person eigene Vorlieben fest: Sprache, Adressstil, automatisches Löschen nach einer Zeit, ob Bilder optimiert werden und, wenn es mehrere gibt, die Domain. Sie gelten im Browser genauso wie für ShareX.
Umgebungsvariablen sind nur noch optional. Du kannst sie als .env im Projektordner, in der docker-compose.yml oder direkt beim Start setzen:
| Variable | Standard | Bedeutung |
|---|---|---|
PORT |
3000 |
Port, auf dem MoeShare lauscht |
DATABASE_URL |
SQLite in db/ |
Datenbank, siehe Datenbank. Hat Vorrang vor der Auswahl im Assistenten. |
FFMPEG_PATH |
ffmpeg aus dem PATH |
Pfad zu FFmpeg für Video-Vorschauen, Streaming, gekürzte Videos und GIFs |
LOG_LEVEL |
info |
debug, info, warn oder error. Mit debug steht jede Anfrage mit Dauer und Request-ID im Log. |
LOG_FORMAT |
text |
text für die Konsole, json für Loki, Graylog, Elasticsearch und Co. |
NO_COLOR / FORCE_COLOR |
Farben im Log abschalten oder erzwingen. Ohne Angabe gibt es Farben nur im Terminal. | |
TZ |
Systemzeit | Zeitzone für die Zeitstempel im Log, etwa Europe/Berlin |
GLITCHTIP_DSN |
Projekt-GlitchTip | Ziel für Fehlerberichte, siehe Protokoll und Fehlerberichte. off schaltet sie ganz ab. |
UPDATE_CHECK_URL |
https://moeshare.moestudio.net/version.json |
Woher die Versionsprüfung die neueste Version holt. off schaltet sie fest ab. |
URL_FETCH_ALLOW_PRIVATE |
false |
„Hochladen per Link“ darf auch Adressen im internen Netz abrufen, ebenso ntfy, Matrix und Mastodon beim automatischen Teilen, dann auch ohne HTTPS. Nur im eigenen Netz einschalten. |
MEMORY_NOTICE_HOUR |
9 |
Ab dieser Stunde (deutsche Zeit) gehen die täglichen Hinweise An diesem Tag raus |
REACTION_NOTICE_DELAY_MS |
600000 |
Wie lange MoeShare neue Reaktionen sammelt, bevor es Bescheid gibt, in Millisekunden |
DNS_SERVERS |
DNS des Systems | DNS-Server für die Prüfung eigener Domains, durch Kommas getrennt, etwa 1.1.1.1,9.9.9.9 |
PUID / PGID |
1000 |
Nur Docker: Benutzer und Gruppe, denen db/ und uploads/ gehören |
DOMAIN |
Nur Docker mit Caddy, siehe Hinter einem Reverse-Proxy | |
POSTGRES_PASSWORD / MARIADB_PASSWORD |
Nur Docker mit docker/postgres.yml bzw. docker/mariadb.yml |
|
UI_DEV_SERVER |
Nur für die Entwicklung, siehe Entwicklung |
Unter Admin › Einstellungen › Allgemein trägst du weitere Domains ein, unter denen MoeShare erreichbar ist. Jede Person wählt dann im Konto eine feste Domain für ihre Links oder lässt sie zufällig wechseln, ShareX kann sie mit X-Domain pro Upload festlegen. Die Domains müssen auf denselben Server zeigen und im Reverse-Proxy eingetragen sein. Anmeldung und Verwaltung laufen weiter über die Hauptadresse. Domains, die nur einer Person gehören, verbindet jede selbst, siehe Eigene Domains.
Die Oberfläche gibt es auf Deutsch und Englisch. Unter Admin › Einstellungen › Allgemein legst du die Sprache des Servers fest und ob MoeShare neuen Besuchern die Sprache ihres Browsers zeigt. Angemeldete wählen ihre Sprache unter Konto › Einstellungen, alle anderen über den Umschalter unten auf jeder Seite. Fehlermeldungen der API kommen in derselben Sprache, E-Mails in der Sprache der Empfänger und Benachrichtigungen in der Sprache des Servers. Das Protokoll bleibt auf Deutsch.
Unter Admin › Einstellungen › Anmeldedienste schaltest du Discord, GitHub, Google, Microsoft, GitLab und einen eigenen OpenID-Connect-Anbieter frei. Für jeden Dienst legst du dort eine App an, trägst Client-ID und Client-Secret in MoeShare ein und hinterlegst beim Dienst die Redirect-Adresse, die MoeShare dir anzeigt. Sie hat immer die Form https://deine-adresse/auth/<dienst>/callback.
| Dienst | App anlegen | Hinweise |
|---|---|---|
| Discord | Developer Portal › OAuth2 | Optional nur für Mitglieder deines Servers, auch mit bestimmten Rollen. Die Mitgliedschaft kann eine Einladung ersetzen. |
| GitHub | Settings › Developer settings › OAuth Apps | Für GitHub Enterprise Server die eigene Adresse unter „GitHub-Adresse“ eintragen. |
| Google Cloud Console › OAuth-Client-ID vom Typ Webanwendung | ||
| Microsoft | Entra Admin Center › App-Registrierungen › Plattform Web | Mandant common für alle Konten, organizations nur für Arbeitskonten, consumers nur für private oder die ID deines Mandanten. |
| GitLab | Einstellungen › Anwendungen, vertraulich mit den Scopes openid und profile |
Für eine eigene GitLab-Instanz deren Adresse eintragen. |
| OpenID Connect | Im Anbieter einen vertraulichen Client mit Authorization Code anlegen | Name für den Button frei wählbar. Als Issuer zum Beispiel https://auth.example.com/application/o/moeshare/ (Authentik), https://sso.example.com/realms/<realm> (Keycloak), https://auth.example.com (Authelia, Pocket ID, Zitadel). |
MoeShare liest den OpenID-Connect-Anbieter über /.well-known/openid-configuration ein und nutzt PKCE, Nonce und State, sofern der Anbieter sie unterstützt.
Beim eigenen OpenID-Connect-Anbieter bestimmen Gruppen, wer hinein darf und wer Admin ist. Unter Anmeldedienste › OpenID Connect › Gruppen trägst du ein, in welchem Claim die Gruppen stehen (meist groups, manchmal roles, verschachtelt mit Punkt wie realm_access.roles), welche Gruppen sich anmelden dürfen und welche Admin werden. Ist eine Gruppe erlaubt, gilt das auch für bestehende Konten, Mitglieder brauchen auf Wunsch keine Einladung. Mit „Admin-Rechte bei jeder Anmeldung abgleichen“ verliert, wer nicht mehr in einer Admin-Gruppe ist, die Rechte bei der nächsten Anmeldung, das letzte Admin-Konto bleibt Admin. MoeShare liest die Gruppen aus dem ID-Token und von userinfo, als Liste, als Text mit Leerzeichen oder Kommas oder als Objekt, dann zählen dessen Schlüssel. Verlangt dein Anbieter dafür einen eigenen Scope wie groups, trägst du ihn bei den Scopes ein.
Wer schon ein Konto hat, verknüpft Dienste unter Konto › Sicherheit › Verbundene Konten und meldet sich danach mit einem Klick an. Ein Konto kann mehrere Dienste haben, jedes Dienstkonto gehört aber nur zu einem MoeShare-Konto. Neue Konten über einen Dienst erlaubst du pro Dienst mit „Neue Konten mit …“, dabei gelten die Regeln unter Anmeldung › Registrierung, also offen, nur mit Einladung oder geschlossen. Ist Zwei-Faktor aktiv, fragt MoeShare auch nach der Anmeldung über einen Dienst nach dem Code.
Unter Admin › Einstellungen › Anmeldung schaltest du die Anmeldung mit Benutzername und Passwort ganz ab. Danach kommen alle nur noch mit einem Passkey, über einen verknüpften Dienst oder mit einem Einmal-Link hinein. Mit abgeschaltet sind dann „Passwort vergessen“, das Ändern und Zurücksetzen von Passwörtern und die Bestätigung mit dem Passwort vor heiklen Änderungen. Gespeicherte Passwörter bleiben erhalten und gelten wieder, sobald du die Anmeldung mit Passwort einschaltest. Die Anmeldung mit ShareX-Token hat einen eigenen Schalter.
Damit sich niemand aussperrt, lässt sich der Schalter nur umlegen, wenn dein eigenes Konto einen Passkey oder einen verknüpften Dienst hat. Aus demselben Grund lassen sich Passkeys und Anmeldedienste danach nicht abschalten, solange du sonst keinen Weg hinein hättest. Wer weder Passkey noch Dienst hat, sieht unter Konto › Sicherheit einen Hinweis mit „Passkey anlegen“.
Neue Konten bekommen kein Passwort mehr. Bei der Registrierung reicht der Benutzername, gleich danach richtet die Person einen Passkey ein. Sind Passkeys abgeschaltet, gibt es neue Konten nur über einen Anmeldedienst. Legt ein Admin ein Konto an, bietet MoeShare direkt einen Einmal-Link für die erste Anmeldung an.
Kommst du selbst nicht mehr hinein, hilft die Kommandozeile: node cli.js login-link <name> gibt einen Einmal-Link aus, node cli.js password-login an schaltet die Anmeldung mit Passwort wieder ein.
Ein Einmal-Link meldet ein Konto genau einmal an, ohne Passwort und ohne Code, und läuft danach von selbst ab. Wer ihn öffnet, ist sofort angemeldet. Vorschauen in Discord, Slack oder Mailprogrammen verbrauchen den Link nicht, denn erst die geöffnete Seite schickt die Anmeldung ab. Ist im Browser schon ein anderes Konto angemeldet, fragt MoeShare vorher nach.
So entstehen Einmal-Links:
- Von Admins unter Admin › Benutzer mit „Einmal-Link“ oder unter Admin › Zugänge. Gültigkeit, eine Seite für danach und eine Notiz sind frei wählbar. Hat das Konto eine bestätigte E-Mail-Adresse, schickt MoeShare den Link auf Wunsch gleich dorthin.
- Per E-Mail angefordert auf der Anmeldeseite mit „Anmeldelink per E-Mail anfordern“. Der Link geht an die bestätigte Adresse und gilt höchstens eine Stunde. Ist Zwei-Faktor aktiv, fragt MoeShare danach noch nach dem Code.
- Über die API: Andere Systeme wie ein Support-Portal oder ein Intranet fordern Links mit einem eigenen Schlüssel an, siehe Einmal-Links über die API.
- Auf der Kommandozeile mit
node cli.js login-link <name>. Das klappt auch, wenn Einmal-Links in den Einstellungen abgeschaltet sind.
Unter Admin › Einstellungen › Anmeldung legst du fest, ob Einmal-Links erlaubt sind, wie lange ein neuer Link üblicherweise gilt (Standard 15 Minuten), wie lange höchstens (Standard 24 Stunden) und ob man sich einen Link per E-Mail schicken lassen kann. Unter Admin › Zugänge stehen alle Links der letzten 30 Tage mit ihrem Stand. Dort holst du einen gültigen Link noch einmal hervor, schickst ihn per E-Mail oder ziehst ihn zurück. Gesperrte Konten bekommen keine Links, beim Sperren verfallen ihre offenen Links.
Jede Anmeldung mit einem Einmal-Link steht im Aktivitätsprotokoll. Stammt der Link von einem Admin, einer Integration oder der Kommandozeile, bekommt die Person eine E-Mail dazu und die Benachrichtigungen melden die Anmeldung als Sicherheitsereignis. Im Link steckt ein zufälliger Schlüssel mit 256 Bit. MoeShare speichert davon nur einen Hash und, solange der Link gilt, eine verschlüsselte Kopie, damit Admins und Integrationen ihn abholen können.
Meldet sich jemand auf einem Gerät an, das für dieses Konto noch nicht dabei war, bekommt die Person eine E-Mail mit Gerät, Uhrzeit, Art der Anmeldung und, wenn MoeShare IP-Adressen protokolliert, der IP-Adresse. Wiedererkannt wird ein Gerät am Cookie ms_device, einer Zufallszahl, die MoeShare nur dafür nutzt und 400 Tage behält. Für deine Datenschutzerklärung: Das Cookie gehört zur Anmeldung und ist technisch notwendig. Die erste Anmeldung eines Kontos löst keine E-Mail aus, und wer schon angemeldet ist, wenn du auf 3.5 aktualisierst, bekommt keine.
Die E-Mail gehört zu den Sicherheitshinweisen, abschalten lässt sie sich unter Konto › Einstellungen › E-Mail. Sie braucht eine eingerichtete E-Mail und eine bestätigte Adresse im Konto. Als Push-Benachrichtigung kommt der Hinweis auch ohne E-Mail aufs Handy.
Unter der Adresse ohne Pfad zeigt MoeShare auf Wunsch eine Startseite mit Dateien, Speicher, Aufrufen, Mitgliedern und den Uploads der letzten 14 Tage. Unter Admin › Startseite stellst du Überschrift, Text, die angezeigten Zahlen und den Upload-Verlauf ein. Eine Vorschau zeigt jede Änderung sofort. Schaltest du die Startseite ab, leitet die Adresse weiter: auf eine Seite deiner Wahl oder, ohne Ziel, zur Anmeldung bzw. ins Dashboard.
Der Name aus Admin › Einstellungen › Allgemein steht überall, wo deine Seite gemeint ist: im Browser-Tab, bei der Anmeldung, in E-Mails, Benachrichtigungen und Link-Vorschauen. „MoeShare“ bleibt nur dort, wo die Software gemeint ist, etwa bei der Version. Den Hinweis „Läuft mit MoeShare“ unten auf der Startseite schaltest du dort ebenfalls ab.
Impressum und Datenschutzerklärung trägst du unter Admin › Einstellungen › Rechtliches und Links ein, entweder als Link auf eine bestehende Seite oder als Text. Text zeigt MoeShare unter /impressum und /datenschutz an, Adressen und E-Mails werden dabei zu Links. Dort legst du auch bis zu acht eigene Links an, etwa zu deinem Discord-Server oder einer Status-Seite. Alle stehen im Fuß jeder Seite, auf der Startseite genauso wie bei der Anmeldung, im Dashboard und auf den Ansichtsseiten.
Der Name aus Admin › Einstellungen › Allgemein steht überall, wo sonst MoeShare stünde: in Seitentiteln, E-Mails, Benachrichtigungen, Dateinamen von Sicherungen und Exporten, ShareX-Konfigurationen und in den DNS-Einträgen für eigene Domains. Aus „Bilder Kiste“ wird dort bilder-kiste, der TXT-Eintrag heißt dann _bilder-kiste.domain mit dem Wert bilder-kiste-verify=…. Einträge mit _moeshare aus älteren Versionen erkennt MoeShare weiter. Webhooks schicken ihre Header als X-Webhook-Event und X-Webhook-Signature, bestehende Ziele zusätzlich noch die alten X-MoeShare-…, bis du das in der Liste abschaltest.
Ohne eigenes Logo zeigt MoeShare sein Symbol als Favicon, im Menü und als App-Symbol. Unter Admin › Einstellungen › Allgemein › Versionshinweise schaltest du „Läuft mit MoeShare“ und die öffentliche Versionsnummer ab, dann sehen sie nur Admins unter Admin › System. Ob es eine neue Version gibt, sagt dir die Versionsprüfung.
Unter Admin › Hinweise schreibst du Ankündigungen: mit Überschrift, Text, Art (Info, Gut, Achtung, Störung) und Zeitraum. Sie erscheinen oben im Dashboard und im Konto, auf Wunsch auch auf der Startseite und bei der Anmeldung oder nur für Admins. Besucher können sie wegklicken, wenn du das erlaubst.
Der Wartungsmodus zeigt allen außer Admins eine Wartungsseite mit deiner Nachricht. Uploads über ShareX und die API bekommen den Status 503 mit derselben Nachricht. Geteilte Links zu Dateien, Alben und Profilen funktionieren auf Wunsch weiter, Admins melden sich normal an und arbeiten wie gewohnt.
MoeShare lässt sich auf dem Handy und am PC wie eine App installieren: In Chrome und Edge über „App installieren“, in Safari über „Zum Home-Bildschirm“. Die App öffnet direkt das Dashboard und hat Abkürzungen für „Hochladen“, „Neuer Text“ und „Link kürzen“. Auf Android taucht MoeShare danach im „Teilen“-Menü auf, so schickst du Fotos, Videos, Texte und Links aus jeder App direkt hin. Das App-Symbol entsteht aus dem Symbol der Seite.
Mit Push-Benachrichtigungen meldet sich die App auch, wenn sie geschlossen ist. Unter Admin › Einstellungen › Allgemein lässt sich die Installation abschalten. Dafür braucht MoeShare HTTPS.
Im Textformat sieht das Log so aus:
2026-10-20 19:12:43 INFO [server] MoeShare 3.2.0 läuft auf https://share.example.com port=3000 node=26.12.0 log=info
2026-10-20 19:12:43 INFO [server] Aktiv: Vorschaubilder, Standortdaten entfernen, Hauptfarbe, Startseite, Passkeys, Anmeldung mit GitHub
2026-10-20 19:13:02 INFO [upload] Datei hochgeladen user=max file=aB3dE9.png size="1,2 MB" via=api
2026-10-20 19:14:10 WARN [audit] Anmeldung fehlgeschlagen user=max ip=203.0.113.7 method=password
2026-10-20 19:15:31 ERROR [http] POST /upload ist fehlgeschlagen: EACCES: permission denied … id=Xk2v9QpL
Bei einem unerwarteten Fehler bekommt der Besucher eine Fehler-ID angezeigt, die du im Log unter id= wiederfindest. Leitet ein Reverse-Proxy eine X-Request-Id weiter, übernimmt MoeShare sie.
Fehlgeschlagene Anmeldungen stehen mit IP-Adresse im Log, solange unter System „IP-Adressen speichern“ an ist. Damit lässt sich zum Beispiel fail2ban füttern:
[Definition]
failregex = ^.* WARN \[(audit|auth)\] Anmeldung fehlgeschlagen .*ip=<HOST>Unter Admin › Einstellungen › System kannst du erlauben, dass MoeShare Fehlermeldungen und vom Browser blockierte Inhalte an das GlitchTip des Projekts schickt. Das ist anfangs aus. Vor dem Senden werden Benutzernamen, IP-Adressen, E-Mail-Adressen, Dateinamen, Tokens und lokale Pfade entfernt, gleiche Fehler gehen höchstens alle zehn Minuten raus. Mit GLITCHTIP_DSN schickst du die Berichte an ein eigenes GlitchTip oder Sentry, mit GLITCHTIP_DSN=off schaltest du sie unabhängig von der Einstellung ab.
Für den Betrieb im Internet gehört MoeShare hinter einen Reverse-Proxy mit HTTPS. Passkeys und die Installation als App funktionieren nur über HTTPS oder localhost.
Die docker-compose.yml bringt dafür Caddy mit, das Zertifikate selbst holt. Caddy braucht dazu die Caddyfile im Ordner docker/, die nicht in der docker-compose.yml steckt. Lade sie neben der docker-compose.yml herunter und trag deine Domain in die .env ein:
mkdir -p docker
curl -o docker/Caddyfile https://raw.githubusercontent.com/MaximilianGT500/moeshare/main/docker/Caddyfile
echo "DOMAIN=share.example.com" >> .env
echo "COMPOSE_PROFILES=caddy" >> .env
docker compose up -dDurch COMPOSE_PROFILES in der .env startet docker compose Caddy bei jedem up mit, auch nach Updates. Die Domain muss auf deinen Server zeigen und die Ports 80 und 443 müssen frei sein. Ist MoeShare noch nicht eingerichtet, öffnest du den Link aus dem Log gleich unter deiner Domain, also https://share.example.com/setup?token=…. Die Caddyfile holt außerdem Zertifikate für eigene Domains, sobald jemand sie aufruft. Vorher fragt Caddy bei MoeShare nach, ob die Domain zu einem Konto gehört.
Lief Caddy schon einmal ohne die Caddyfile, hat Docker an ihrer Stelle einen leeren Ordner docker/Caddyfile angelegt, und Caddy startet nicht. Entferne ihn vor dem Download mit sudo rmdir docker/Caddyfile.
Ohne Docker reicht in Caddy:
share.example.com {
reverse_proxy localhost:3000
}
Mit eigenen Domains kommen Zertifikate auf Abruf dazu:
{
on_demand_tls {
ask http://localhost:3000/api/domains/tls
}
}
share.example.com {
reverse_proxy localhost:3000
}
https:// {
tls {
on_demand
}
reverse_proxy localhost:3000
}
Mit nginx:
server {
server_name share.example.com;
client_max_body_size 0;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Request-Id $request_id;
}
}Danach unter Admin › Einstellungen die Adresse auf https://share.example.com setzen und unter System „Hinter einem Reverse-Proxy“ einschalten. nginx kann keine Zertifikate auf Abruf holen. Wer dort eigene Domains anbieten will, trägt jede selbst mit Zertifikat ein oder setzt Caddy davor.
Unter Admin › Caddy spricht MoeShare mit der Admin-API von Caddy. Im Docker-Paket ist sie unter http://caddy:2019 erreichbar und wird von selbst gefunden, bei einer eigenen Installation trägst du die Adresse unten in der Seite ein, meist http://127.0.0.1:2019. Dort siehst du:
- jedes Zertifikat der Hauptadressen und eigenen Domains mit Aussteller, Ablaufdatum und Restlaufzeit. Abgelaufene, bald ablaufende oder nicht vertrauenswürdige Zertifikate stehen oben
- welche Seiten Caddy kennt, wohin sie weiterleiten und ob die Ziele erreichbar sind
- jede Anfrage von Caddy nach einem Zertifikat für eine Domain, mit erlaubt oder abgelehnt
- Hinweise, wenn etwas nicht passt, etwa Zertifikate auf Abruf ohne Rückfrage
Einmal am Tag prüft MoeShare alle Zertifikate. Läuft eins in weniger als 14 Tagen ab (einstellbar) oder stimmt etwas nicht, bekommen Admins eine E-Mail und die Benachrichtigungen für Systemmeldungen feuern. Unten auf der Seite steht eine passende Caddyfile für Docker oder eine direkte Installation, mit allen Adressen und eigenen Domains. Du kannst sie anpassen, von Caddy prüfen lassen und mit einem Klick laden. Das ändert die laufende Konfiguration, nicht die Datei auf dem Server.
Wer eine eigene Caddyfile nutzt, gibt die Admin-API für den MoeShare-Container frei:
{
admin :2019 {
origins caddy:2019 localhost:2019
}
}Der Port 2019 bleibt dabei im Docker-Netz und wird nicht nach außen veröffentlicht.
Unter Admin › Einstellungen › System › Metriken für Prometheus erstellst du ein Token. Damit liefert /metrics Zahlen zu Konten, Dateien, Speicher, Aufrufen, Sitzungen, offenen Meldungen und Datei-Anfragen sowie die Restlaufzeit jedes Zertifikats. Der Eintrag für die prometheus.yml steht nach dem Erstellen direkt daneben:
scrape_configs:
- job_name: moeshare
scheme: https
metrics_path: /metrics
authorization:
credentials: msm_…
static_configs:
- targets: ['share.example.com']Ohne Token antwortet /metrics mit 401, abgeschaltet gar nicht.
Einmal am Tag fragt MoeShare unter https://moeshare.moestudio.net/version.json nach, ob es eine neue Version gibt. Abgerufen wird nur diese Datei, ohne Angaben über deinen Server, seinen Namen oder die installierte Version. Gibt es eine neue Version, sehen Admins einen Hinweis im Dashboard und im Admin-Bereich. Einmal pro Version feuern außerdem die Benachrichtigungen für Systemmeldungen, und Admins, die Systemmeldungen per E-Mail bekommen, erhalten eine Nachricht. Sicherheitsupdates sind als solche markiert.
Unter Admin › System › Updates stehen die installierte und die neueste Version mit den wichtigsten Neuerungen, wann zuletzt geprüft wurde und der passende Befehl zum Aktualisieren, je nachdem, ob MoeShare mit Docker, dem Installationsskript oder Git läuft. „Jetzt prüfen“ fragt sofort nach. Auf der Kommandozeile zeigt node cli.js version dasselbe.
Abschalten lässt sich die Prüfung dort oder unter Admin › Einstellungen › System › Nach neuen Versionen suchen, danach stellt MoeShare keine Anfrage mehr. Mit UPDATE_CHECK_URL=off ist sie fest aus. Mit einer eigenen Adresse fragt MoeShare dort nach, etwa für einen Fork. Die Datei sieht so aus, Pflicht ist nur version:
{
"version": "3.8.0",
"date": "2026-11-17",
"changelog": "https://moeshare.moestudio.net/changelog.html#v3.8.0",
"security": false,
"notes": {
"de": ["Automatisch teilen an sechs Dienste, smarte Alben und Jahresrückblick"],
"en": ["Automatic sharing to six services, smart albums and year in review"]
}
}Was neu ist und worauf du beim Update achten musst, steht im Changelog.
- MoeShare stoppen und eine Sicherung von
db/unduploads/anlegen. Wer schon Version 3 nutzt, nimmt dafürnode cli.js backup --uploads. - Den neuen Stand holen (
git pulloderdocker compose pull). npm installausführen (bei Docker übernimmt das das Image).- MoeShare starten.
Beim ersten Start sichert MoeShare die Datenbank automatisch nach db/backups/ und bringt sie auf den neuen Stand. Bestehende Discord-Verknüpfungen bleiben dabei erhalten. Werte aus einer alten .env (zum Beispiel SITE_TITLE oder MAX_FILE_SIZE_MB) werden einmalig übernommen, danach meldet das Log, welche Variablen du entfernen kannst. Bisherige ShareX-Tokens funktionieren weiter. Für Konten aus älteren Versionen ist zunächst auch die Anmeldung mit dem Token möglich, damit sich alle ein Passwort setzen können. Unter Admin › Einstellungen › Anmeldung schaltest du das ab.
Beim Update auf 3.8 legt MoeShare Tabellen für Reaktionen auf Dateien und Alben, für gesammelte Hinweise auf Reaktionen und für die Regeln zum automatischen Teilen an. Dateien bekommen Beschreibung, Alternativtext, Favoriten und einen Zeitpunkt zum späteren Veröffentlichen, Alben eine Regel für smarte Alben. Reaktionen, Einbetten, automatisches Teilen und Teilen per E-Mail sind danach erlaubt, Reaktionen und der Knopf „Einbetten“ erscheinen auf allen Ansichtsseiten und Alben, bis jemand sie unter Gestalten ausblendet. Hinweise auf Reaktionen und „An diesem Tag“ bleiben aus, bis jede Person sie selbst einschaltet. Wer im Reverse-Proxy eigene Header setzt, lässt für /frame/ ein X-Frame-Options weg, sonst lassen sich Dateien nicht einbetten. Die Pfade frame und oembed sind ab jetzt als eigener Pfad reserviert.
Beim Update auf 3.7 legt MoeShare eine Tabelle für eigene Symbole an. Bestehende Links auf Profilseiten bekommen ein automatisches Symbol und bleiben in der Reihe wie bisher, mit „Kein Symbol“ sehen sie aus wie vorher. Wer die Weboberfläche selbst baut, führt in client/ einmal npm install aus, dort ist das Paket simple-icons dazugekommen.
Beim Update auf 3.6 legt MoeShare eine Tabelle für Geräte mit Push-Benachrichtigungen an. Push ist danach erlaubt, einschalten muss es jede Person selbst auf ihren Geräten. Verschlüsselte Uploads sind ebenfalls erlaubt, der Hotlink-Schutz bleibt aus, bis du ihn einschaltest. Wer im Reverse-Proxy eine eigene Content Security Policy setzt, ergänzt blob: bei connect-src und frame-src, sonst bleiben entschlüsselte Dateien und PDFs in der Vorschau leer.
Beim Update auf 3.5 legt MoeShare eine Tabelle für bekannte Geräte an, die für den Hinweis bei neuen Anmeldungen gebraucht wird. Wer angemeldet bleibt, bekommt dabei keine E-Mail. Gesperrte Dateitypen gibt es erst, wenn du welche einträgst, und die Discord-App ist aus, bis du sie einschaltest.
Beim Update auf 3.4 legt MoeShare die Tabellen für Datei-Anfragen, Ankündigungen, Untertitel und Zertifikate an. Eigene Domains brauchen ab jetzt ein Impressum und eine Datenschutzerklärung, Domains, die schon verbunden sind, haben dafür 14 Tage Zeit und laufen so lange weiter. TXT-Einträge mit _moeshare gelten weiter, auch wenn deine Instanz anders heißt. Eigene Webhooks bekommen die Header X-Webhook-Event und X-Webhook-Signature und bis zum Abschalten zusätzlich die alten X-MoeShare-…. Zeigte das Logo auf das alte Logo von moeshare.eu, nutzt MoeShare jetzt sein eingebautes Symbol. Für Videos aus älteren Versionen startest du unter Admin › System › Videos „Alle Videos prüfen“ oder node cli.js videos. Wer eine eigene Caddyfile nutzt, gibt für Admin › Caddy die Admin-API frei, siehe Caddy verwalten. Ab 3.4.1 fragt die Versionsprüfung bei moeshare.moestudio.net statt bei GitHub nach, eine abgeschaltete Prüfung bleibt aus.
Beim Update auf 3.3 legt MoeShare die Tabellen für Profilbilder, eigene Pfade, Einmal-Links und Integrationen an. Die Anmeldung mit Passwort bleibt eingeschaltet. Einmal-Links und der Anmeldelink per E-Mail sind danach erlaubt, unter Admin › Einstellungen › Anmeldung schaltest du beides ab. Benachrichtigungen, die bisher als „MoeShare“ geschrieben haben, nutzen jetzt den Namen deiner Instanz.
Beim Update auf 3.2 wird ein bisheriger Discord-Webhook zum ersten Ziel unter Benachrichtigungen. Für vorhandene Dateien berechnet MoeShare danach im Hintergrund Prüfsummen für die Duplikate und baut den Suchindex auf, das läuft nebenher und braucht nichts von dir.
Stand in der alten .env eine REDIRECT_URL, leitet die Adresse ohne Pfad weiter wie bisher. Die neue Startseite schaltest du unter Admin › Startseite ein. Datenbanken, die einmal aus PostgreSQL umgewandelt wurden (Tabellen mit public. im Namen), passt MoeShare beim Start selbst an.
Läuft MoeShare bei dir mit einem älteren Docker-Image, trägst du in der docker-compose.yml ghcr.io/maximiliangt500/moeshare:latest ein oder nimmst gleich die neue Datei aus dem Repository. Die Ordner db/ und uploads/ bleiben gleich.
Ohne Docker braucht MoeShare 3 Node.js 24 oder neuer. Prüf die Version mit node --version und aktualisiere Node.js vor dem Update, etwa über nodejs.org oder den Versionsmanager deiner Wahl.
Unter Admin › Einstellungen › Sicherungen schaltest du automatische Sicherungen ein. Du legst fest, wie oft MoeShare sichert, wie viele automatische Sicherungen bleiben und ob die hochgeladenen Dateien mit hineinkommen. Ältere automatische Sicherungen räumt MoeShare selbst weg, manuelle bleiben, bis du sie löschst. Die Sicherungen liegen in db/backups/ oder, wenn S3 eingerichtet ist, auf Wunsch im Bucket. Dort startest du auch eine Sicherung von Hand und lädst sie herunter.
Eine Sicherung ist ein .tar.gz mit der ganzen Datenbank, der Schlüsseldatei db/.secret und auf Wunsch den Dateien. Sie passt zu jeder Datenbank: Eine Sicherung aus SQLite lässt sich auch in PostgreSQL oder MariaDB einspielen. Zum Zurückspielen MoeShare beenden und dann:
node cli.js restore moeshare-backup-20261022-101509.tar.gzOhne Pfad sucht MoeShare die Datei in db/backups/. Enthält die Datenbank schon Daten, bricht restore ab, mit --force werden sie vorher gelöscht. Mit --ohne-dateien kommt nur die Datenbank zurück.
Wer lieber selbst sichert, nimmt diese Ordner mit:
db/mit der Datenbank und der Schlüsseldateidb/.secret. Ohne die Schlüsseldatei lassen sich Zwei-Faktor-Einstellungen, S3-Zugangsdaten und offene Einmal-Links nicht mehr lesen.uploads/mit allen Dateien, sofern sie nicht in S3 liegen.- Bei PostgreSQL oder MySQL zusätzlich einen Dump der Datenbank, etwa mit
pg_dumpodermysqldump.
| Befehl | Zweck |
|---|---|
npm run register |
Konto anlegen und ein ShareX-Token ausgeben |
npm run token |
Neues API-Token nach Benutzername und Passwort |
npm run reset |
Notfallzugang: Passwort, Rolle, Sperre, Zwei-Faktor, Passkeys oder Tokens zurücksetzen |
node cli.js login-link <name> [--minuten 30] [--ziel /dashboard] |
Gibt einen Einmal-Link für das Konto aus, auch wenn Einmal-Links abgeschaltet sind |
node cli.js password-login <an|aus> |
Schaltet die Anmeldung mit Passwort ein oder ab, ohne Angabe zeigt der Befehl den Stand |
node cli.js db |
Zeigt die genutzte Datenbank und die Einträge pro Tabelle |
node cli.js copy-db <adresse> [--use] |
Kopiert alle Daten in eine andere Datenbank, mit --use direkt umstellen |
node cli.js backup [--uploads] |
Erstellt eine Sicherung, mit --uploads samt Dateien |
node cli.js restore <datei> [--force] [--ohne-dateien] |
Spielt eine Sicherung ein |
node cli.js storage <s3|lokal> |
Verschiebt vorhandene Dateien nach S3 oder zurück auf den Server |
node cli.js videos |
Prüft vorhandene Videos: Abmessungen, Vorschaubilder und Fassungen für alle Browser |
node cli.js version |
Zeigt die installierte Version und fragt nach, ob es eine neuere gibt, siehe Versionsprüfung |
node cli.js import <zipline|xbackbone|chibisafe> --db <adresse> --files <ordner> |
Übernimmt einen anderen Uploader, siehe Import. Mit --probe nur ein Probelauf, --ohne-admins macht niemanden zum Admin, --waisen-ueberspringen lässt Dateien ohne Besitzer weg, --als <admin> bestimmt, wem sie gehören. |
Mit Docker heißen die Befehle docker compose exec moeshare moeshare register, … moeshare login-link max, … moeshare backup und so weiter. Sie laufen dort mit dem Benutzer, dem die Datenbank gehört. Für copy-db und restore muss MoeShare gestoppt sein, nimm dafür docker compose run --rm moeshare moeshare …. Legst du das erste Konto mit register an, ist der Installationsassistent nicht mehr nötig und die Einstellungen machst du danach im Browser.
Skripte und Uploader melden sich mit einem API-Token im Header Authorization an. Alle Upload-Wege verstehen die Angaben aus der Tabelle unter ShareX verbinden, als Header oder als Feld im Formular bzw. im JSON (expires, password, once, maxViews, urlStyle, domain, title, description, alt, syntax, tags, album, warning, optimize, watermark, publishAt).
| Methode | Pfad | Beschreibung |
|---|---|---|
POST |
/upload |
Datei im Formularfeld file hochladen. Antwort: { success, file, view, preview, delete, id, … }, bei einer Datei, die schon im Konto liegt, zusätzlich duplicateOf |
POST |
/api/texts |
Text hochladen, als Feld content (Formular oder JSON) oder als text/plain. Antwort wie bei /upload |
POST |
/api/shorten |
Kurzlink für die Adresse im Feld url anlegen. Antwort: { success, url, target, code } |
POST |
/api/files/:id/versions |
Neue Fassung einer eigenen Datei im Formularfeld file, die id stammt aus der Antwort von /upload. Antwort: { ok, file } |
POST |
/api/uploads |
Großen Upload in Teilen beginnen, siehe unten |
GET |
/api/uploads |
Unfertige Uploads des eigenen Kontos |
GET |
/files |
Dateinamen des eigenen Kontos, neueste zuerst |
GET |
/api/files/cleanup |
Dateien zum Aufräumen, mit kind=large, unseen oder stale und page. Antwort: { files, total, summary: { count, bytes }, … } |
GET |
/api/files?starred=1 |
Nur Favoriten, auch mit search, type, tag und page. Dazu scheduled=1 für geplante Dateien, alt=missing für Bilder und Videos ohne Alternativtext und sort=reactions für die meisten Reaktionen zuerst |
GET |
/api/files/memories |
Rückblick für heute: { memories: [{ years, files }] } |
GET |
/api/files/year?year=2025 |
Jahresrückblick: Uploads, Größe, Typen, Monate, Wochentage, Stunden, Serie, beliebteste Dateien und mehr, ohne year das laufende Jahr |
PATCH |
/api/files/:id |
Eigene Datei ändern, unter anderem title, description, alt, starred, tags, warning und publishAt (null veröffentlicht sofort). Antwort: { file } |
POST |
/api/files/:id/email |
Datei per E-Mail teilen: { to: [..], message }. Antwort: { ok, sent } |
POST |
/api/albums |
Album anlegen, mit rule: { tag, type, starred, days } als smartes Album. PATCH /api/albums/:id ändert die Regel, rule: null macht es wieder zu einem normalen Album |
POST |
/api/albums/:id/email |
Album per E-Mail teilen, wie bei Dateien |
PATCH |
/api/tags/:tag |
Tag umbenennen oder mit { name } in einen vorhandenen zusammenführen. DELETE /api/tags/:tag löscht ihn |
GET |
/api/account/autoshare |
Regeln zum automatischen Teilen: { enabled, rules, kinds, types, max }. POST legt eine an (kind plus die Felder des Ziels, dazu name, tag, types, template), PATCH /api/account/autoshare/:id ändert sie, DELETE entfernt sie, POST /api/account/autoshare/:id/test schickt eine Testnachricht |
DELETE |
/file/:dateiname |
Eigene Datei in den Papierkorb legen, ohne Papierkorb sofort löschen. Antwort: { ok, trashed } |
Öffentlich erreichbar sind /view/:dateiname (Ansichtsseite), /download/:dateiname, /view/:dateiname/zip und /view/:dateiname/zip/:nr (Inhalt von ZIP-Archiven und einzelne Dateien daraus), /uploads/:benutzer/:dateiname (die Datei selbst), /s/:code (Kurzlinks), /a/:code (Alben), /a/:code/zip (Album als ZIP), /u/:benutzer (Profilseiten), /u/:benutzer/icons/:schlüssel (eigene Symbole), /u/:benutzer/contact.vcf (Kontakt speichern), /frame/:dateiname, /frame/a/:code und /frame/u/:benutzer (Einbetten), /oembed?url=… (oEmbed für Dateien, Alben und Profile), POST /view/:dateiname/react und POST /a/:code/react mit { "reaction": "love" } (Reaktionen), /a/:code/feed.xml und /u/:benutzer/feed.xml (RSS-Feeds), /r/:code (Datei-Anfragen), /api/discord/interactions (nur mit Signatur von Discord, siehe Discord-App), /report (Inhalt melden), /oembed/:dateiname, /api/home (Statistiken der Startseite), /api/domains/tls (Abfrage für Caddy), /impressum, /datenschutz und /healthz für Health-Checks. /metrics antwortet nur mit dem Token aus Metriken für Prometheus. Geschützte Dateien liefert MoeShare erst nach Eingabe des Passworts auf der Ansichtsseite aus.
curl -H "Authorization: ms_…" -F "file=@bild.png" https://share.example.com/upload
curl -H "Authorization: ms_…" -H "X-Expires: 1d" -H "X-Syntax: bash" --data-binary @skript.sh -H "Content-Type: text/plain" https://share.example.com/api/texts
curl -H "Authorization: ms_…" -d "url=https://example.com/ein/sehr/langer/pfad" https://share.example.com/api/shortenGroße Dateien gehen in Teilen hoch, so lässt sich ein abgebrochener Upload fortsetzen:
POST /api/uploadsmit JSON{ "name": "video.mp4", "size": 734003200 }beginnt den Upload. Die Angaben zum Upload wieexpiresoderalbumkommen als Header oder ins selbe JSON. Mit"fileId"wird daraus eine neue Fassung einer vorhandenen Datei. Die Antwort enthält dieid, die empfohlene Größe der TeilechunkSize(8 MB) und die größte erlaubtemaxChunk(64 MB).PATCH /api/uploads/:idschickt das nächste Teil mitContent-Type: application/offset+octet-streamund dem HeaderUpload-Offset, der Zahl der Bytes, die schon angekommen sind. Die Antwort nennt den neuen Stand inreceivedund im HeaderUpload-Offset. Passt der Offset nicht, antwortet MoeShare mit 409 und dem richtigen Stand.POST /api/uploads/:id/completeschließt den Upload ab. Die Antwort ist dieselbe wie bei/upload.
GET /api/uploads/:id zeigt den Stand nach einem Abbruch, DELETE /api/uploads/:id verwirft den Upload. Unfertige Uploads verfallen nach 24 Stunden ohne neues Teil, einstellbar unter Admin › Einstellungen › Uploads.
DATEI=video.mp4
GROESSE=$(stat -c %s "$DATEI")
ID=$(curl -s -H "Authorization: ms_…" -H "Content-Type: application/json" \
-d "{\"name\":\"$DATEI\",\"size\":$GROESSE}" https://share.example.com/api/uploads | jq -r .id)
OFFSET=0
while [ "$OFFSET" -lt "$GROESSE" ]; do
OFFSET=$(tail -c +$((OFFSET + 1)) "$DATEI" | head -c 8388608 | curl -s -X PATCH -H "Authorization: ms_…" \
-H "Content-Type: application/offset+octet-stream" -H "Upload-Offset: $OFFSET" --data-binary @- \
https://share.example.com/api/uploads/$ID | jq -r .received)
done
curl -s -X POST -H "Authorization: ms_…" https://share.example.com/api/uploads/$ID/completeFür andere Systeme legst du unter Admin › Zugänge › Integrationen eine Integration an. Sie bekommt einen eigenen Schlüssel (msi_…), der nur Einmal-Links anfordern kann und sonst nichts. Für jede Integration wählst du den Ablauf:
- Admin gibt frei: Jede Anfrage wartet unter Admin › Zugänge auf eine Freigabe, Admins bekommen dazu eine E-Mail und eine Benachrichtigung. Nach der Freigabe holt die Integration den Link ab oder der Admin gibt ihn selbst weiter. Ohne Freigabe verfällt die Anfrage nach 24 Stunden.
- Sofort ausstellen: Die Antwort enthält den Link direkt, die Integration gibt ihn selbst weiter.
Dazu kommen eine eigene Höchstdauer und die Erlaubnis, Links auch für Admin-Konten anzufordern. Ohne diese Erlaubnis lehnt MoeShare Anfragen für Admins ab. Persönliche API-Tokens (ms_…) können keine Einmal-Links anfordern. Pro Adresse sind 60 Anfragen in der Minute erlaubt.
| Methode | Pfad | Beschreibung |
|---|---|---|
POST |
/api/integrations/login-links |
Link anfordern, als JSON mit user (Benutzername), email (bestätigte Adresse) oder userId. Optional: minutes, redirect (eine Seite auf dem Server wie /dashboard), note und deliver: "email". Antwort 201 mit url oder bei Freigabe 202 mit status: "pending" |
GET |
/api/integrations/login-links/:id |
Stand einer eigenen Anfrage: pending, ready (dann mit url), used, expired, revoked oder denied |
DELETE |
/api/integrations/login-links/:id |
Eigenen Link oder eigene Anfrage zurückziehen |
GET |
/api/integrations/info |
Name, Ablauf und erlaubte Gültigkeit der Integration |
Mit deliver: "email" schickt MoeShare den Link selbst an die bestätigte Adresse der Person, bei einer Integration mit Freigabe direkt nach der Freigabe. Fehler kommen wie überall als JSON mit error und, wo es passt, field.
curl -H "Authorization: Bearer msi_…" -H "Content-Type: application/json" \
-d '{"user": "max", "minutes": 15, "note": "Ticket 4711"}' \
https://share.example.com/api/integrations/login-linksAntwort einer Integration mit Freigabe:
{
"id": 42,
"status": "pending",
"user": { "id": 3, "username": "max" },
"minutes": 15,
"note": "Ticket 4711",
"redirect": null,
"createdAt": 1762509600000,
"expiresAt": 1762596000000,
"decidedAt": null,
"usedAt": null
}Sobald ein Admin freigegeben hat, liefert GET /api/integrations/login-links/42 den Stand ready und den Link im Feld url. Er gilt ab der Freigabe für die angefragten Minuten.
npm install
npm run build
npm run dev:ui
UI_DEV_SERVER=http://localhost:5173 npm startnpm run build baut die Weboberfläche aus client/ nach public/app. Mit npm run dev:ui und UI_DEV_SERVER lädt die Oberfläche Änderungen sofort neu. npm run typecheck prüft den TypeScript-Code, die Formatierung folgt der .prettierrc.json.
Die Texte der Oberfläche sind auf Deutsch geschrieben und dienen gleichzeitig als Schlüssel für die Übersetzung. Die englischen Texte liegen in src/i18n/client/en.json (Weboberfläche) und src/i18n/server/en.json (Fehlermeldungen, Seitentitel, Benachrichtigungen). Ein neuer Text braucht in der Oberfläche t('…') und einen Eintrag in der passenden Datei, Platzhalter wie {name} bleiben dabei gleich.
| Ordner | Inhalt |
|---|---|
src/routes |
Seiten und API, nach Bereichen getrennt |
src/services |
Logik für Benutzer, Dateien, Alben, Kurzlinks, Designs, Domains, Statistiken, Meldungen, E-Mail, Einstellungen, Speicher, Sicherungen, Anmeldung und mehr |
src/lib |
Datenbank für SQLite, PostgreSQL und MySQL, S3, ClamAV, Protokoll, Medienverarbeitung, die Importer für andere Uploader und Hilfsfunktionen |
src/assets |
Die Schrift Inter für Wasserzeichen, unter der SIL Open Font License |
src/middleware |
Anmeldung, Sicherheitsregeln, Request-IDs und Fehlerbehandlung |
src/i18n |
Englische Übersetzungen für Oberfläche und Server |
client/src |
Weboberfläche mit React und Material UI |
docker/ |
Startskript, Kommandozeile, Caddyfile und die Ergänzungen für PostgreSQL, MariaDB und ClamAV |
cli.js |
Befehle für die Kommandozeile |
Fehler und Ideen gerne als Issue oder Pull Request, siehe CONTRIBUTING.md. Kontakt gibt es auch über meine Website.
Teile der ursprünglichen README und der docker-compose.yml stammen von ass.
MoeShare steht unter der MIT-Lizenz.