Zum Inhalt springen
SONOYA.com
Selfhosting & Web

PicoShare mit Coolify: Dateien teilen per Ablauf-Link

Eigenes WeTransfer mit PicoShare: in Coolify installieren, Dateien mit ablaufenden Links teilen, Gast-Uploads erlauben und per picaroa vom iPhone senden.

Von

Upload-Symbol auf dunklem Verlauf für PicoShare, einen selbst gehosteten Dienst zum Teilen von Dateien mit ablaufenden Links, eingerichtet mit Coolify

Eine 2 GB große Videodatei an einen Kunden, ein Ordner Urlaubsfotos an die Familie, ein Logfile an einen Kollegen: Für solche Fälle greifen viele zu WeTransfer, Dropbox oder Google Drive und laden ihre Dateien damit auf fremde Server, oft mit Größenlimit, Werbung oder Zwang zum Konto. Wenn Du ohnehin einen eigenen Server mit Coolify betreibst, geht das einfacher. Mit PicoShare lädst Du eine Datei hoch, bekommst sofort einen Link, und nach einem Tag, einer Woche oder einem Datum Deiner Wahl verschwindet die Datei von selbst. Diese Anleitung zeigt Dir, wie Du PicoShare in wenigen Minuten mit Coolify aufsetzt, wie die ablaufenden Links und Gast-Uploads funktionieren und wie Du mit der iPhone-App picaroa direkt aus dem Teilen-Menü Dateien verschickst.

Stand der Anleitung ist PicoShare 1.5.5 (November 2026), picaroa 1.1 und Coolify 4. Alle Optionen und Bezeichnungen sind mit dem Quellcode von PicoShare 1.5.5 und der offiziellen Doku von Coolify abgeglichen.

Was PicoShare kann und was nicht

PicoShare ist eine kleine Open-Source-Webanwendung von Michael Lynch, geschrieben in Go. Sie läuft als ein einziger Docker-Container und speichert alle Dateien in einer SQLite-Datenbank im Ordner /data. Es gibt keine Benutzerverwaltung, sondern genau ein Passwort für Dich als Administrator, das sogenannte Shared Secret. Wer einen Link von Dir bekommt, braucht weder Konto noch Passwort.

Für das schnelle Teilen bringt PicoShare genau das mit, was Du brauchst:

  • Ablaufende Links. Bei jedem Upload wählst Du unter Expiration zwischen 1 day, 7 days, 30 days, 1 year, Never oder einem eigenen Datum über Custom. Danach löscht PicoShare die Datei automatisch.
  • Kein Größenlimit für Dich. Uploads des Administrators begrenzt PicoShare bewusst nicht, auch mehrere Gigabyte gehen durch.
  • Gast-Links. Du erzeugst einen Upload-Link, über den andere Dir Dateien schicken können, mit eigener Laufzeit, Größenlimit und Höchstzahl an Uploads.
  • Passphrase und Notiz. Seit Version 1.5.5 kannst Du einen Download zusätzlich mit einer Passphrase schützen. Eine Notiz wie „Für Jana, Rohschnitt“ bleibt für Empfänger unsichtbar.
  • Download-Protokoll. In den Details einer Datei siehst Du, wie oft und wann sie heruntergeladen wurde.

Was PicoShare nicht kann: Ordner synchronisieren, Dateien gemeinsam bearbeiten oder mehrere Benutzerkonten verwalten. Dafür ist Nextcloud das passende Werkzeug. PicoShare ist das schlanke Gegenstück für „Datei hoch, Link raus, nach einer Woche weg“.

Ein Hinweis zur Herkunft: Der Quellcode ist im November 2026 von GitHub zu Codefloe umgezogen, das alte GitHub-Repository ist archiviert. Das Docker-Image heißt weiterhin mtlynch/picoshare und kommt wie bisher von Docker Hub. Die Übersichtsseite dort ist allerdings veraltet und nennt noch Port 3001. Richtig ist Port 4001.

Was ist picaroa?

picaroa ist eine kostenlose, werbefreie iPhone-App für PicoShare. Sie stammt nicht vom PicoShare-Entwickler, sondern von einem unabhängigen Entwickler, und wird in der README von PicoShare als Client von Drittanbietern aufgeführt. Die App spricht ausschließlich mit Deinem eigenen Server. Das Shared Secret legt sie im iOS-Schlüsselbund ab.

Mit picaroa lädst Du Fotos, Videos und Dateien direkt aus dem Teilen-Menü von iOS hoch, packst mehrere Dateien auf Wunsch in ein ZIP-Archiv mit Passwort, zeigst den Link als QR-Code an und verwaltest Gast-Links. Fehlt unterwegs das Netz, landen Uploads in einer Warteschlange und gehen später raus. Optional entfernt die App vor dem Upload die EXIF-Daten aus Fotos, also etwa den Aufnahmeort. picaroa braucht iOS 26.5 oder neuer und läuft auf dem iPhone. Eine Android-Version gibt es nicht, dort nutzt Du einfach die Weboberfläche im Browser.

Voraussetzungen

Für die Einrichtung brauchst Du:

  • einen Server mit installiertem Coolify 4, der aus dem Internet erreichbar ist,
  • eine Domain oder Subdomain, etwa share.deinedomain.de, deren A-Record auf die IP-Adresse dieses Servers zeigt,
  • ausreichend Speicherplatz auf dem Server, denn jede hochgeladene Datei liegt dort, bis sie abläuft.

Hast Du noch keinen Server, reicht für PicoShare ein kleiner VPS mit 1 GB RAM. Ein Droplet bei DigitalOcean (Affiliate Link) ist schnell angelegt, wichtiger als CPU oder RAM ist hier die Größe der Festplatte. Wie Du in Coolify einen Service anlegst und Variablen setzt, zeigt auch der Artikel GitHub Actions Minuten aufgebraucht: Runner mit Coolify an einem zweiten Beispiel.

Schritt 1: PicoShare in Coolify anlegen

Coolify bringt für PicoShare kein fertiges Service-Template mit. Das ist kein Problem, denn eine kurze Docker-Compose-Datei reicht.

  1. Öffne in Coolify Dein Projekt und die Umgebung, in der PicoShare laufen soll, etwa production.
  2. Klicke auf + New und wähle Docker Compose Empty.
  3. Wähle den Server aus, falls Coolify danach fragt.
  4. Füge in das Feld Docker Compose file diesen Inhalt ein:
Code
services:
  picoshare:
    image: mtlynch/picoshare:v1.5.5
    command: -db /data/store.db
    environment:
      - SERVICE_URL_PICOSHARE_4001
      - PORT=4001
      - PS_SHARED_SECRET=${SERVICE_PASSWORD_PICOSHARE}
      - PS_BEHIND_PROXY=true
    volumes:
      - picoshare-data:/data

volumes:
  picoshare-data:
  1. Klicke auf Save.

Coolify prüft die Datei und öffnet danach die Konfiguration des neuen Service. Die einzelnen Zeilen bewirken Folgendes:

ZeileBedeutung
image: mtlynch/picoshare:v1.5.5Das offizielle Image in einer festen Version, damit ein Neustart nicht ungeplant aktualisiert
command: -db /data/store.dbDie SQLite-Datenbank mit allen Dateien liegt im dauerhaften Volume
SERVICE_URL_PICOSHARE_4001Sagt Coolify, dass der Container auf Port 4001 lauscht, damit der Proxy dorthin weiterleitet
PS_SHARED_SECRETDein Admin-Passwort; SERVICE_PASSWORD_PICOSHARE lässt Coolify ein zufälliges 32-stelliges Passwort erzeugen
PS_BEHIND_PROXY=truePicoShare protokolliert die echte IP-Adresse der Besucher statt der des Proxys
picoshare-data:/dataEin Docker-Volume, das Uploads und Datenbank über Neustarts und Updates hinweg behält

Einen ports:-Eintrag gibt es absichtlich nicht. Coolify leitet den Verkehr über seinen eingebauten Traefik-Proxy mit HTTPS an den Container weiter, Port 4001 muss nach außen nicht offen sein. Mehr zu Volumes und Variablen in Compose-Dateien erklärt der Artikel Docker Compose verstehen: Volumes, Netzwerke und .env.

Schritt 2: Domain eintragen und starten

Hast Du in Coolify eine Wildcard-Domain für den Server hinterlegt, hat Coolify dem Service bereits eine zufällige Adresse zugeteilt. Für einen Link, den Du an andere schickst, ist eine eigene, sprechende Adresse aber schöner.

  1. Klicke in der Konfiguration des Service beim Eintrag picoshare auf die Einstellungen des Containers.
  2. Trage im Feld Domains Deine Adresse mit dem internen Port ein:
Code
https://share.deinedomain.de:4001
  1. Speichere mit Save.

Der Zusatz :4001 ist kein öffentlicher Port. Er sagt dem Proxy nur, an welchen Port im Container die Anfragen gehen. Besucher rufen später ganz normal https://share.deinedomain.de auf, und Coolify besorgt das Let’s-Encrypt-Zertifikat automatisch.

Starte den Service anschließend oben mit Deploy. Coolify lädt das Image, legt das Volume an und startet den Container. Nach etwa einer halben Minute springt der Status auf Running.

Schritt 3: Anmelden und prüfen, ob alles läuft

Dein Passwort steht im Service unter Environment Variables in der Variable SERVICE_PASSWORD_PICOSHARE. Klicke auf das Augensymbol, kopiere den Wert und leg ihn in Deinem Passwortmanager ab. Wenn Du lieber ein eigenes Passwort verwendest, ersetzt Du den Wert dort und startest den Service mit Restart neu.

Öffne nun https://share.deinedomain.de im Browser. Du siehst die Startseite von PicoShare. Melde Dich mit dem Passwort an, danach erscheint die Upload-Seite. Ob alles richtig eingerichtet ist, erkennst Du an drei Dingen:

  • Im Browser steht ein gültiges Schloss vor der Adresse, das Zertifikat ist also ausgestellt.
  • Ein Testupload einer kleinen Datei endet mit Upload complete!, und der kopierte Link lädt die Datei in einem privaten Browserfenster ohne Anmeldung herunter.
  • Nach einem Restart des Service ist die Testdatei noch da. Damit ist bewiesen, dass das Volume greift.

Zieh eine Datei auf die Upload-Seite oder klicke auf Choose a file…. Darunter stellst Du ein, wie lange sie verfügbar bleibt:

  • Expiration: 1 day für den schnellen Austausch, 7 days oder 30 days für Kunden und Familie, Custom für ein festes Datum, Never nur für Dateien, die dauerhaft erreichbar sein sollen.
  • Note: eine Notiz, die nur Du in der Dateiliste siehst, zum Beispiel für wen die Datei gedacht ist.
  • Passphrase: ein optionales Kennwort, das der Empfänger vor dem Download eingeben muss. Sinnvoll für vertrauliche Unterlagen, denn ein Link allein kann weitergeleitet werden. Die Passphrase schickst Du am besten auf einem anderen Weg, etwa per Messenger statt per E-Mail.

Nach dem Upload kopierst Du den Link und schickst ihn weiter. In der Dateiliste im Menü oben siehst Du alle Uploads mit ihrem Ablaufdatum. Über Edit bei einer Datei änderst Du die Laufzeit nachträglich oder löschst sie vorzeitig, und in ihren Details siehst Du, wann und mit welchem Browser sie abgerufen wurde.

Welche Laufzeit vorausgewählt ist, legst Du unter Settings bei Default File Expiration fest. Stell dort zum Beispiel 7 und Days ein und speichere mit Save. So bleibt keine Datei aus Versehen für immer liegen, nur weil Du vergessen hast, die Laufzeit umzustellen.

Oft ist es umgekehrt: Jemand soll Dir eine große Datei schicken und hat selbst keinen passenden Dienst. Dafür legst Du im Menü bei den Gast-Links einen neuen Link an. Die Seite heißt Create Guest Link und hat diese Felder:

FeldEmpfehlung
LabelWofür der Link ist, etwa „Fotos Hochzeit Meier“; sieht nur Du
Guest Link ExpiresWie lange der Upload-Link selbst gilt, meist 7 days
Guest Files ExpireWie lange die hochgeladenen Dateien höchstens bleiben, etwa 30 days
Max file sizeObergrenze pro Datei in MB, zum Beispiel 2000
Upload limitWie viele Dateien insgesamt hochgeladen werden dürfen

Klicke auf Create und schick den Link weiter. Der Gast sieht eine einfache Upload-Seite ohne Anmeldung und ohne Zugriff auf Deine anderen Dateien. Die Dateien erscheinen anschließend in Deiner Dateiliste. Setz bei Gast-Links immer eine Laufzeit und ein Größenlimit, denn ein Link ohne Grenzen erlaubt jedem, der ihn in die Finger bekommt, Deine Festplatte zu füllen.

picaroa auf dem iPhone einrichten

Lade picaroa aus dem App Store und öffne die App. Sie fragt beim ersten Start nach zwei Angaben:

  1. Server-URL: https://share.deinedomain.de, also genau die Adresse aus Schritt 2, ohne :4001.
  2. Shared Secret: das Passwort aus Schritt 3.

Nach dem Anmelden siehst Du Deine Dateiliste mit allen Uploads aus der Weboberfläche. Ab jetzt teilst Du eine Datei, indem Du sie in der Fotos- oder Dateien-App markierst, auf das Teilen-Symbol tippst und picaroa wählst. Du wählst die Laufzeit zwischen einem Tag und „nie“, die App lädt hoch und gibt Dir den Link zum Weiterschicken. Für jemanden, der neben Dir steht, lässt Du Dir den Link als QR-Code anzeigen.

Wenn etwas nicht klappt

Die Seite zeigt „No available server“ oder einen 502-Fehler. Der Proxy findet den Container nicht auf dem angegebenen Port. Prüfe, ob im Feld Domains wirklich :4001 steht und PORT=4001 in der Compose-Datei unverändert ist. Ein Blick in die Logs des Service zeigt, ob PicoShare gestartet ist.

Das Zertifikat wird nicht ausgestellt. Meist zeigt der DNS-Eintrag noch nicht auf den Server oder ist noch nicht verteilt. Prüfe den A-Record mit dig share.deinedomain.de +short im Terminal; es muss die IP-Adresse Deines Servers erscheinen. Danach den Service neu deployen.

Große Uploads brechen bei rund 100 MB ab. Weder PicoShare noch der Traefik-Proxy von Coolify setzen hier eine Grenze. Läuft die Domain aber über den Proxy von Cloudflare (orange Wolke), begrenzt Cloudflare im kostenlosen Tarif jede Anfrage auf 100 MB. Stell den DNS-Eintrag für die Subdomain dort auf DNS only.

Die Festplatte wird trotz gelöschter Dateien nicht leerer. SQLite gibt den Platz gelöschter Dateien nicht sofort an das Dateisystem zurück, sondern verwendet ihn für neue Uploads weiter. Das ist normal. Wenn Du den Platz wirklich freigeben willst, empfiehlt der Entwickler, PicoShare zu stoppen und die Datenbank mit sqlite3 store.db 'VACUUM' zu verkleinern.

Updates und Datensicherung

Für ein Update änderst Du im Service über Edit Compose File die Versionsnummer hinter mtlynch/picoshare:, speicherst und klickst auf Deploy. Die neuen Versionen findest Du auf der Release-Seite bei Codefloe. Lies vor dem Sprung auf eine neue Hauptversion die Release Notes.

Das Volume ist kein Backup. Geht der Server verloren, sind auch alle Dateien weg. Für reine Wegwerf-Links ist das oft verkraftbar. Liegen auf PicoShare Dateien, die Du nicht noch woanders hast, richte die eingebaute Sicherung mit Litestream ein, die die Datenbank laufend in einen S3-kompatiblen Speicher wie DigitalOcean Spaces repliziert. Dafür ergänzt Du in der Compose-Datei die Variablen LITESTREAM_BUCKET, LITESTREAM_ENDPOINT, LITESTREAM_ACCESS_KEY_ID und LITESTREAM_SECRET_ACCESS_KEY mit den Zugangsdaten Deines Buckets. Startet der Container neu, stellt PicoShare die Daten von dort automatisch wieder her.

Fazit

PicoShare ersetzt WeTransfer für alle, die schon einen Server mit Coolify haben, mit einem einzigen Container und einer Compose-Datei von gut einem Dutzend Zeilen. Die Dateien liegen auf Deinem eigenen Server, die Links verschwinden zuverlässig nach der gewählten Zeit, und mit picaroa geht das Teilen vom iPhone so schnell wie über AirDrop, nur eben auch an Menschen, die nicht neben Dir sitzen.

Weiterlesen.