AmiCloud

Handbuch — eigener Cloud-Speicher für AmigaOS 3.x und PC · Stand 08.11.2026 (Programmversion 0.10)

Dieses Handbuch gehört zu AmiCloud 0.10. Der schnelle Einstieg steht in der Schritt-für-Schritt-Anleitung.

AmiCloud verbindet den Amiga über HTTPS mit einem eigenen AmiCloud-Server. Die Dateien darauf lassen sich per Kommandozeile, in einer interaktiven Shell, mit einem Dateimanager oder als ganz normales Laufwerk AMICLOUD: benutzen. Kommandozeilenprogramme und Dateimanager gibt es auch für macOS, Linux und Windows. Dieses Handbuch entspricht inhaltlich dem AmigaGuide-Handbuch AmiCloud.guide.

1. Einführung

AmiCloud ist ein selbst betriebener Cloud-Speicher, der für den Amiga gemacht ist. Ein kleiner PHP-Server auf einem Linux-Rechner hält die Dateien, jeder Benutzer hat seinen eigenen Bereich. Alle Programme sprechen den Server ausschließlich über HTTPS an; auf dem Amiga übernehmen das bsdsocket.library und AmiSSL 5, auf dem PC libcurl.

┌────────────────────────┐   HTTPS   ┌──────────────────────────────┐
│ amicloud, -shell,      │◄─────────►│ Apache + PHP                 │
│ amicloud-sync, Commander   │           │   api.php  REST-API          │
│ (Amiga und PC)         │           │   web.php  Weboberfläche     │
└────────────────────────┘           │ MariaDB (Benutzer, Metadaten)│
┌────────────────────────┐   HTTPS   │ Speicher/<benutzer>/        │
│ AMICLOUD:-Handler (Amiga) │◄─────────►│                              │
└────────────────────────┘           └──────────────────────────────┘

Der Server merkt sich neben dem Dateiinhalt auch Amiga-Eigenschaften: Protection-Bits, Dateikommentare und das Änderungsdatum. Über AMICLOUD: funktionieren deshalb auch Protect, FileNote und SetDate.

2. Voraussetzungen

Stack muss nicht eingestellt werden: die Programme fordern beim Start selbst 64 KB an, der Handler erhält 16 KB über seinen DOSDriver, der Worker 64 KB beim Start durch den Handler.

Speicher: Der AMICLOUD:-Handler hält eine geöffnete Datei vollständig im Arbeitsspeicher. Für sehr große Dateien lieber amicloud get/put benutzen, die direkt von und auf die Platte übertragen.

3. Installation mit Install-AmiCloud Amiga

Die Installationsschublade AmiCloud (zum Beispiel aus AmiCloud.lha) enthält:

AmiCloud/
  Install-AmiCloud          Installationsskript (Commodore-Installer)
  Install-AmiCloud.shell    dasselbe als Shell-Skript
  Uninstall-AmiCloud        Deinstallationsskript
  ReadMe                    Kurzbeschreibung
  LICENSE                   GNU GPL Version 3
  THIRD-PARTY-NOTICES       Lizenz der Fremdkomponente Parson (MIT)
  C/                        alle Programme
  Docs/AmiCloud.guide       Handbuch (AmigaGuide)
  Examples/                 amicloud.cfg.example, AMICLOUD.mountlist
  Storage/DOSDrivers/AMICLOUD  DOSDriver für AMICLOUD:

Alle Teile haben Workbench-Icons. Zum Installieren in der Schublade das Icon Install-AmiCloud doppelt anklicken. Es startet den Commodore-Installer (bei AmigaOS 3.2 in SYS:System, bei älteren Systemen von der Install-Diskette nach C: kopieren). Ohne Installer gibt es dasselbe als Shell-Skript:

CD AmiCloud
Execute Install-AmiCloud.shell

Wer den Installer aus der Shell startet, wechselt vorher mit CD in die Schublade: Das Skript sucht seine Dateien relativ zum aktuellen Verzeichnis. Von einem anderen Verzeichnis aus bricht es mit einem Hinweis ab.

Aktualisieren: Eine neuere Version installiert man genauso – Archiv auspacken, Installer erneut starten. Er vergleicht bei jedem Programm die installierte Version mit der im Archiv. Als Einsteiger oder Geübter Benutzer ersetzt er gleiche und ältere Versionen; eine neuere installierte Version bleibt stehen und wird am Ende genannt. Im Expertenmodus zeigt er bei jedem schon installierten Programm beide Versionen und fragt. Vorhandene Icons (mit eigenen Tooltypes und Positionen) bleiben erhalten. Die Shell-Variante fragt nur nach, wenn ein installiertes Programm neuer ist als das im Archiv. Ist AMICLOUD: schon gemountet, arbeitet es bis zum nächsten Neustart mit der alten Version weiter.

Das Skript fragt, welche Teile installiert werden sollen (im Installer per Auswahlliste, im Shell-Skript mit y oder n):

1. Kommandozeilenprogramme nach C:
2. amicloud-commander nach SYS:Tools
3. AmiCloudPrefs nach SYS:Prefs
4. AMICLOUD:-Handler nach L: und DEVS:DOSDrivers

Danach legt es ENVARC:amicloud.cfg und ENV:amicloud.cfg aus der Beispieldatei an – aber nur, wenn es sie noch nicht gibt. Eine vorhandene Konfiguration und ein vorhandener DOSDriver DEVS:DOSDrivers/AMICLOUD werden nie überschrieben. Anschließend bietet das Skript an, AmiCloudPrefs zu starten (dort Server, Benutzer und Passwort eintragen und Speichern wählen) und AMICLOUD: sofort zu mounten. Ist HELP: zugewiesen, kopiert es das Handbuch nach HELP:AmiCloud.guide.

amicloud list /
Dir AMICLOUD:

Für die Programme werden keine Icons mitgeliefert. Wer AmiCloudPrefs oder den Commander von der Workbench starten möchte, legt sich ein Icon an.

4. Manuelle Installation Amiga

Copy C/amicloud C/amicloud-shell C/amicloud-sync C:
Copy C/amicloud-commander SYS:Tools/
Copy C/AmiCloudPrefs SYS:Prefs/
Copy C/amicloud-handler C/amicloud-worker L:
Copy Storage/DOSDrivers/AMICLOUD DEVS:DOSDrivers/
Copy Examples/amicloud.cfg.example ENVARC:amicloud.cfg   ; nur ohne vorhandene
Copy ENVARC:amicloud.cfg ENV:amicloud.cfg                ; Konfiguration

5. AmiCloud auf dem PC macOS · Linux · Windows

Für den PC gibt es amicloud, amicloud-shell, amicloud-sync und den Dateimanager amicloud-commander (Qt 6). Sie werden aus den Quellen gebaut (Kapitel 16) und mit make install nach /usr/local/bin installiert (PREFIX/DESTDIR werden unterstützt), oder von Hand aus bin/pc/ kopiert.

Konfiguration: dieselben Schlüssel wie auf dem Amiga (Kapitel 7), die Datei heißt ~/.amicloudrc (Windows-Builds ohne MSYS-Umgebung: amicloud.cfg im aktuellen Verzeichnis). Der Qt-Commander liest ~/.amicloudrc (Windows ohne HOME: %USERPROFILE%\.amicloudrc) und fragt fehlende Angaben in einem Verbindungsdialog ab, speichert sie aber nicht.

cp config-examples/amicloud.cfg.example ~/.amicloudrc
chmod 600 ~/.amicloudrc
amicloud list /

6. Den Server einrichten

Der Server liegt dem Archiv als Schublade Server bei und läuft auf Linux mit Apache 2.4, PHP 7.4 oder neuer (Erweiterungen pdo_mysql, fileinfo und mbstring, für ZIP-Downloads zip) und MariaDB/MySQL. HTTPS ist Pflicht: die API lehnt Klartext-HTTP mit 403 ab. Die vollständige Anleitung mit allen Befehlen steht in INSTALL.md im Server-Paket; hier die Kurzfassung für amicloud.example.com:

1. Virtual Host mit DocumentRoot /var/www/amicloud und AllowOverride All anlegen. Der Server gehört an die Wurzel des Hostnamens, weil web.php sich mit /web.php verlinkt.
2. HTTPS: sudo certbot --apache -d amicloud.example.com
3. Dateien: sudo cp -r server/. /var/www/amicloud/ – mit Punkt, damit die .htaccess-Dateien mitkommen. Speicherverzeichnis /var/amicloud-storage außerhalb des Web-Verzeichnisses anlegen, beides dem Apache-Benutzer geben.
4. config.php aus config.php.example kopieren und ausfüllen (Tabelle unten).
5. Datenbank: sudo mysql < /var/www/amicloud/sql/schema.sql, dann einen DB-Benutzer mit SELECT, INSERT, UPDATE, DELETE auf amicloud.* anlegen. sql/migrate_001.sql bis migrate_004.sql sind nur für ältere Installationen.
6. Ersten Administrator anlegen (Passwort wird abgefragt):

   cd /var/www/amicloud
   sudo -u apache php bin/amicloud-admin.php user:add --admin bob

   Weitere Benutzer legt der Administrator in der Weboberfläche an.
7. Testen:

   curl -u bob:geheim "https://amicloud.example.com/api.php?action=status"
   AC_SERVER=https://amicloud.example.com AC_USER=bob AC_PASS=geheim \
       sh scripts/test_api.sh

   Weboberfläche: https://amicloud.example.com/web.php

Die Weboberfläche

Unter https://amicloud.example.com/web.php bedient sich die Cloud im Browser ähnlich wie ownCloud:

• Dateien hochladen (auch ganze Ordner und per Ziehen und Ablegen), umbenennen, verschieben, löschen, mehrere als ZIP herunterladen
• Suche über alle eigenen Dateien, Liste Zuletzt geändert
• Details zu jeder Datei mit MD5, Protection-Bits und dem Amiga-Dateikommentar, der sich dort auch ändern lässt
• Öffentliche Links: eine Datei oder einen Ordner freigeben, wahlweise mit Passwort und Ablaufdatum
• Persönliche Einstellungen: Anzeigename, E-Mail, Passwort und App-Passwörter
• für Administratoren: Benutzer anlegen, Speicherkontingent festlegen, Passwort zurücksetzen, sperren, löschen

App-Passwörter

Statt des Kontopassworts gehört in amicloud.cfg am besten ein eigenes App-Passwort je Gerät (Persönliche Einstellungen → Geräte & App-Passwörter). Es hat die Form xxxxx-xxxxx-xxxxx-xxxxx-xxxxx, wird nur einmal angezeigt (mit fertigen Zeilen für amicloud.cfg) und lässt sich einzeln widerrufen, wenn ein Gerät verloren geht.

7. Konfiguration: amicloud.cfg

Alle AmiCloud-Programme lesen dieselbe Datei. Jede Zeile hat die Form schluessel=wert, Zeilen mit # am Anfang sind Kommentare.

server=https://amicloud.example.com
user=bob
pass=geheim
#basepath=/
#verify_ssl=1
#debug=T:amicloud.log
#gmt_offset=60
#dst=0
#timeout=120
#cache_ttl=30

Umlaute in Dateinamen (ab 0.3): Der Server speichert Namen in UTF-8, der Amiga in seinem eigenen Zeichensatz. Alle Programme und der AMICLOUD:-Handler wandeln um, über die codesets.library (ab Version 6, Aminet util/libs/codesets). Fehlt sie, gilt ISO-8859-1. Zeichen, die es im lokalen Zeichensatz nicht gibt (Emoji, chinesische Schrift), erscheinen als _; die Datei bleibt unter diesem Namen erreichbar, und der Abgleich ordnet sie wieder richtig zu.

Gleiche Namen bis auf Groß-/Kleinschreibung: Auf dem Server können abc und ABC (auch Äpfel und äpfel) nebeneinander liegen, auf dem Amiga wären sie eine Datei. Der Handler zeigt dann die erste (nach Zeichencode) unter ihrem Namen, die anderen als abc_2, abc_3 usw., vor der Endung (x_2.info); ebenso zwei Namen, die beide als _ erscheinen würden. Unter diesen Namen lassen sie sich lesen, schreiben, umbenennen und löschen. Der Abgleich, get -r und das Kopieren im Commander (auch unter macOS und Windows) holen solche Namen nicht, sondern melden sie.

gmt_offset und dst werden von amicloud-shell und vom AMICLOUD:-Handler ausgewertet. Die Amiga-Uhr kennt keine Zeitzone; ohne passende Werte stimmen die Datumsangaben von Dateien nicht mit dem Server überein. Auf dem PC werden beide Werte ignoriert.

ENV: ist nach einem Neustart leer; damit die Einstellungen bleiben, gehört die Datei auch nach ENVARC: – AmiCloudPrefs erledigt das mit Speichern. Kommandozeilenoptionen (-s, -u, -p, -d, -k) gehen den Werten aus der Datei vor.

8. AmiCloudPrefs Amiga

Aufruf: SYS:Prefs/AmiCloudPrefs. Ein GadTools-Fenster mit den Feldern Server, Benutzer, Passwort, Basis-Pfad, Zertifikat prüfen, Debug-Ziel, GMT-Offset (Min) und Sommerzeit – also allen Schlüsseln aus Kapitel 7.

Unterscheiden sich ENV: und ENVARC:, zeigt die Statuszeile einen Hinweis; angezeigt werden dann die Werte aus ENV:. Der AMICLOUD:-Handler liest die Datei nur einmal beim Start – geänderte Einstellungen wirken dort erst nach einem Neustart.

9. amicloud – Kommandozeilen-Client Amiga + PC

amicloud [Optionen] <Befehl> [Argumente]

Remote-Pfade mit führendem / sind absolut, alle anderen beziehen sich auf den Basis-Pfad. Die MD5-Prüfsumme wird bei get und put während der Übertragung geprüft. Suchmuster: *, ? und die AmigaDOS-Form #?. Rückgabewert: 0 bei Erfolg.

amicloud list /
amicloud put S:Startup-Sequence /backup/Startup-Sequence
amicloud get /backup/Startup-Sequence RAM:ss
amicloud mkdir /archiv
amicloud rename /backup/Startup-Sequence /archiv/ss-alt
amicloud info /archiv/ss-alt
amicloud search '#?.txt' /
amicloud -s https://amicloud.example.com -u bob -p geheim list

Zielname: Ohne Zielangabe verwendet put den Teil hinter dem letzten / oder : – aus DH0:bericht.txt wird /bericht.txt, aus DH0:texte/bericht.txt ebenfalls. Nur ein Pfad ohne Dateinamen (z. B. DH0:) wird abgelehnt.

10. amicloud-shell – interaktive Shell Amiga + PC

amicloud-shell [Optionen] – Optionen wie bei amicloud (-s -u -p -d -c -k -v --help). Nach dem Start zeigt die Shell Server, Serverversion, Benutzer sowie Remote- und lokales Verzeichnis und wartet auf Befehle. Mit Cursor hoch/runter lassen sich frühere Eingaben der Sitzung wiederholen.

Listen-Optionen: -n nur Namen, -s mit Größe, -d mit Datum, -m mit MD5 (lokal jedes Mal neu berechnet); ohne Option Name, Größe, Datum und Typ. Gleichwertig sind -r, --recursive, RECURSIVE, ALL (rekursiv) sowie -f, --force, FORCE (ohne Rückfrage: löschen bzw. überschreiben). Muster (* ? #?) sind bei get und put erlaubt. Auf dem Amiga bedeutet lcd .. dasselbe wie lcd /. Befehle lassen sich auch aus einer Datei lesen: amicloud-shell <befehle.txt.

Überschreiben: get und put fragen, bevor sie eine vorhandene Datei ersetzen. Bei einer einzelnen Datei genügt y oder n. Bei Mustern und -r zeigt die Shell Größe, Datum und – wenn bekannt – ob der Inhalt gleich ist, und bietet an: y überschreiben, n überspringen, a alle weiteren überschreiben, s alle weiteren überspringen, c ganzen Vorgang abbrechen; einfach Return überspringt. Mit -f wird ohne Frage überschrieben. Liest die Shell ihre Befehle aus einer Datei, ist keine Antwort möglich: Dann wird nichts überschrieben (Einzeldatei: nein, Muster/-r: Abbruch), und die Shell weist auf -f hin.

/> cd archiv
/archiv> lcd RAM:
/archiv> get -r fotos
/archiv> put #?.txt
/archiv> ls -d
/archiv> quit

11. amicloud-sync – Ordner abgleichen Amiga + PC

amicloud-sync [Optionen] <lokaler-ordner> <remote-ordner>

amicloud-sync gleicht einen lokalen Ordner einmalig in beide Richtungen mit einem Ordner auf dem Server ab und beendet sich dann – kein Hintergrunddienst. So wird entschieden:

• nur auf einer Seite geändert → wird zur anderen Seite übertragen
• auf beiden Seiten gleich geändert → nichts zu tun
• auf beiden Seiten verschieden geändert → Konflikt (ab 0.3): beide Fassungen bleiben erhalten. Die Fassung vom Server behält den Namen, die lokale wird zur Konfliktkopie Name_KJJMMTT-HHMM.ext (z. B. brief_K261031-2237.txt) und ebenfalls hochgeladen. Sind beide Fassungen inhaltsgleich, passiert nichts.
• auf einer Seite gelöscht, auf der anderen geändert → die geänderte Fassung wird wieder auf die andere Seite übertragen; nichts Geändertes geht verloren
• Datei auf der einen, Ordner gleichen Namens auf der anderen Seite → die Datei wird zur Konfliktkopie, der Ordner bleibt
• auf einer Seite gelöscht, auf der anderen unverändert → die Löschung wird übertragen

Den Stand des letzten Abgleichs merkt sich amicloud-sync in der Datei .amicloudsync im lokalen Ordner. Beim ersten Abgleich werden fehlende Ordner auf beiden Seiten angelegt (nicht beim Probelauf). Rückgabewert 1, wenn Fehler auftraten, sonst 0.

Schutz vor Datenverlust (ab 0.2)

• Kann ein Ordner auf einer Seite nicht gelesen werden (Netzfehler, gesperrter Ordner), bricht der Abgleich ab, bevor er etwas ändert.
• Ctrl-C bricht nach der laufenden Übertragung ab. Ein abgebrochener Abgleich löscht nichts; der nächste macht den Rest.
• Ist der Ordner auf dem Server verschwunden (etwa umbenannt), wird er nicht leer neu angelegt; der Abgleich bricht ab.
• Gehört .amicloudsync zu einem anderen Server, Benutzer oder Server-Ordner, wird der Stand verworfen. Der Abgleich führt dann nur zusammen und löscht nichts.
• Ein Ordner wird nur gelöscht, wenn auch alles darin gelöscht wird. Liegt darin etwas Neues, wird er wieder angelegt.
• Dateien, die während des Abgleichs geändert werden, werden weder überschrieben noch gelöscht.
• Hochgeladen wird nur, wenn die Datei auf dem Server noch die beim Abgleich gesehene ist. Sonst bleibt die Datei bis zum nächsten Abgleich liegen, der beide Fassungen behält.
• Namen, die sich nur in Groß-/Kleinschreibung unterscheiden (auch Ä/ä), und Namen, die für das Dateisystem zu lang sind (klassisches FFS: 30 Zeichen), werden übersprungen und gemeldet.
• Nie abgeglichen werden .DS_Store, ._*, Thumbs.db, desktop.ini, ~$*, *.part sowie Namen mit Backslash oder Steuerzeichen.

Viele Löschungen auf einmal (ab 0.3): Würde ein Abgleich auf einer Seite mehr als 20 Einträge und mehr als die Hälfte des letzten Stands löschen (etwa weil ein Ordner versehentlich geleert wurde), fragt er vorher nach. Wer verneint, behält die Dateien: der nächste Abgleich kopiert sie auf die geleerte Seite zurück. Im Probelauf (-n) gibt es stattdessen eine Warnung. In Skripten ohne Rückfrage: -f bzw. FORCE (vor oder hinter den Ordnern).

Die Abschlusszeile zählt Konfliktkopien („1 Konfliktkopie(n)“) und nicht ausgeführte Löschungen („20 Loeschung(en) zurueckgehalten“) mit.

Lokale Dateien bekommen die Ortszeit nach gmt_offset und dst aus amicloud.cfg (die Sommerzeit wird von Hand umgestellt).

Schneller bei großen Ordnern (ab 0.3): Hat sich auf dem Server etwas geändert, holt der Abgleich nur noch die Liste der Änderungen seit dem letzten Mal, statt jeden Ordner einzeln abzufragen. Jeder 20. Abgleich liest trotzdem alles, ebenso nach einem Konflikt, nach mehr als 30 Tagen Pause oder wenn der Server-Ordner selbst umbenannt wurde. Das braucht den Server ab migrate_006.sql.

Virenprüfung (ab 0.3, optional): Ist die xvs.library installiert (Aminet util/virus), prüfen Abgleich, Kommandozeile, Shell und Dateimanager jede Datei bis 2 MB vor dem Hochladen und vor dem Ablegen eines Downloads. Eine verseuchte Datei wird weder übertragen noch gelöscht, sondern als Fehler mit dem Namen des Virus gemeldet. Ohne die Bibliothek wird nicht geprüft.

amicloud-sync -n Work:Texte /texte      ; erst schauen
amicloud-sync Work:Texte /texte         ; dann abgleichen

AmiCloud Desktop – Abgleich im Hintergrund macOS

AmiCloud Desktop gleicht wie der ownCloud-Client einen Ordner im Hintergrund ab. Es sitzt als Wolke in der Menüleiste und nutzt denselben Abgleich wie amicloud-sync, mit allen Schutzregeln oben (Konfliktkopien, Rückfrage bei vielen Löschungen). Es läuft auf Macs mit Apple-Chip ab macOS 26. Das Programm gehört nicht zum Aminet-Archiv; ein öffentlicher Download folgt mit der Veröffentlichung auf GitHub, Windows und Linux später.

• Einrichten: Beim ersten Start fragt ein Assistent nach Server-Adresse, Benutzer und App-Passwort (die Schaltfläche „App-Passwort im Browser anlegen“ öffnet die passende Seite der Weboberfläche), dem lokalen Ordner (Vorgabe ~/AmiCloud) und der Auswahl.
• Auswahl: Ein Startordner auf dem Server (Vorgabe /) und darunter ein Baum mit Häkchen. Gespeichert wird, was abgewählt ist; neue Server-Ordner sind also automatisch dabei. Wird ein Ordner abgewählt, der schon auf dem Mac liegt, fragt das Programm: in den Papierkorb oder behalten (dann wird er nicht mehr abgeglichen). Auf dem Server bleibt er in jedem Fall. Ein später wieder gewählter Ordner wird zusammengeführt wie beim ersten Abgleich, gelöscht wird dabei nichts.
• Menü: Zustand und laufende Übertragung, „Jetzt abgleichen“, „Pause“/„Fortsetzen“ (hält auch eine laufende Übertragung an, der Rest folgt danach), „Ordner öffnen“, „Im Browser öffnen“, „Aktivität …“ (alle Aktionen, Konflikte und Fehler), „Einstellungen …“ (Konto, Ordner und Auswahl, Abstand der Abgleiche, Grenzen für die Rückfrage beim Löschen).
• Abgelehnte Anmeldung: Lehnt der Server das App-Passwort ab (etwa weil es widerrufen wurde), fragt das Programm nicht weiter nach, bis ein neues eingetragen ist. So sperrt die Login-Bremse des Servers das Konto nicht für die anderen Geräte, den Amiga eingeschlossen.
• Passwort: Das App-Passwort liegt in einer eigenen Datei, die nur der Benutzer lesen kann (~/Library/Preferences/AmiCloud/AmiCloud Desktop/credentials), nicht im Schlüsselbund.

• Wann abgeglichen wird: wenige Sekunden nach einer Änderung im lokalen Ordner und außerdem nach Zeitplan (Vorgabe alle 5 Minuten), damit Änderungen auf dem Server ankommen.
• Papierkorb: Was der Abgleich auf dem Mac löscht, weil es auf dem Server gelöscht wurde, landet im Papierkorb, ein ganzer Ordner als Einheit. Geht das nicht, wird nichts gelöscht, sondern ein Fehler gemeldet.
• Start bei der Anmeldung: Einstellungen → Abgleich → „Bei der Anmeldung starten“. macOS fragt eventuell nach einer Erlaubnis unter Systemeinstellungen → Allgemein → Anmeldeobjekte.
• Installation: AmiCloud-Desktop-0.7.dmg öffnen und das Programm auf „Programme“ ziehen. Es ist nicht von Apple beglaubigt: Beim ersten Start unter Systemeinstellungen → Datenschutz & Sicherheit „Trotzdem öffnen“ wählen.

12. amicloud-commander – Dateimanager

Ein Dateimanager mit zwei Panels nebeneinander. Jedes Panel zeigt über seinen Umschalter entweder lokale Dateien (Local) oder die Cloud (AmiCloud). Das zuletzt angeklickte Panel ist das aktive.

MUI-Fassung Amiga

Aufruf: amicloud-commander [-v] (braucht MUI 3.8). Server und Zugangsdaten kommen aus ENV:amicloud.cfg (sonst amicloud.cfg im aktuellen Verzeichnis); fehlt dort server, user oder pass, meldet der Commander das und beendet sich. Beim Start zeigt links das aktuelle Verzeichnis, rechts der Basis-Pfad in der Cloud.

Der Commander gibt normalerweise nichts auf der Konsole aus. Zur Fehlersuche: -v beim Start aus der Shell, oder beim Start von der Workbench das Tooltype DEBUG im Icon. Die MUI-Fassung ist auf echter Hardware noch wenig erprobt.

Qt-Fassung PC

Aufruf: amicloud-commander [-v|--verbose]. Liest ~/.amicloudrc; fehlen Angaben, fragt ein Verbindungsdialog danach (ohne zu speichern). Gleiche Funktionstasten F2–F10 (zusätzlich Tab wechselt das Panel, Entf löscht, Esc beendet). Unterschiede:

• F6 verschiebt zwischen Local und AmiCloud (mit Rückfrage) und benennt um, wenn beide Panels dieselbe Quelle zeigen.
• F4 fragt zusätzlich nach dem Suchbereich (aktueller Ordner oder alles) und ob Ordner mitgesucht werden.
• Menüs: Ansicht (Versteckte Dateien ausblenden), Extras (Prüfsumme anzeigen, Suchen…), Hilfe (Über AmiCloud Commander…).

Gemeinsam

• Existiert eine Datei beim Kopieren schon, zeigt eine Abfrage Größe, Datum und MD5 beider Seiten; zur Wahl stehen Überschreiben, Überspringen, Alle überschreiben, Alle überspringen und Abbruch.
• Laufende Übertragungen zeigen einen Fortschrittsbalken mit Abbrechen-Knopf.
• Die Statuszeile zeigt den belegten Cloud-Speicher (höchstens alle 30 Sekunden neu abgefragt).
• Kopieren von Cloud zu Cloud ist nicht möglich.

13. AMICLOUD:-Handler – die Cloud als Laufwerk Amiga

Der Handler macht den eigenen Cloud-Bereich zu einem AmigaDOS-Laufwerk AMICLOUD:; auf der Workbench erscheint es als Datenträger AmiCloud. Installation: amicloud-handler und amicloud-worker nach L:, der DOSDriver AMICLOUD nach DEVS:DOSDrivers/, dazu eine vollständige ENV:amicloud.cfg (Kapitel 3).

Mount AMICLOUD:          ; sofort (sonst beim nächsten Systemstart automatisch)
Dir AMICLOUD:
MakeDir AMICLOUD:Texte
Copy DH0:bericht.txt AMICLOUD:Texte/
Copy AMICLOUD:Texte/bericht.txt RAM:
Rename AMICLOUD:Texte/bericht.txt AMICLOUD:Texte/alt.txt
Protect AMICLOUD:Texte/alt.txt +p
FileNote AMICLOUD:Texte/alt.txt "Mein Kommentar"
SetDate AMICLOUD:Texte/alt.txt today
Delete AMICLOUD:Texte ALL

Was funktioniert: Lesen, Schreiben, Anlegen, Löschen und Umbenennen von Dateien und Verzeichnissen, Protection-Bits, Dateikommentare (bis 79 Zeichen), Datum setzen, Workbench-Fenster auf AmiCloud.

So arbeitet er: Der Handler selbst (amicloud-handler) beantwortet nur die DOS-Pakete. Die gesamte Netzwerkarbeit erledigt ein zweiter Prozess, amicloud-worker, den der Handler beim Mounten aus L: startet (er wartet bis zu 30 Sekunden darauf). Der Worker liest ENV:amicloud.cfg einmal beim Start und baut die Netzverbindung erst bei der ersten Anfrage auf – das Mounten beim Booten klappt deshalb auch, wenn der TCP/IP-Stack später startet. Verzeichnisinhalte werden 30 Sekunden zwischengespeichert (cache_ttl). Beim Lesen holt der Handler nur die Teile einer Datei, die ein Programm tatsächlich liest – zeigt die Workbench „Alle Dateien“ an, kostet eine Datei ohne Icon nur 4 KB, nicht ihre ganze Größe. Wird eine Datei geändert, lädt er sie ganz in den Speicher und lädt sie beim Schließen wieder hoch.

Grenzen

• Kein Abmelden: AMICLOUD: bleibt bis zum Neustart gemountet. Neue Programmversionen und geänderte Einstellungen wirken erst danach.
• Anfragen an den Server laufen nacheinander. Während einer langsamen Übertragung beantwortet AMICLOUD: trotzdem alles, was ohne Server geht: Info, Lesen und Schreiben bereits geöffneter Dateien, Inhalte frisch gelesener Verzeichnisse. Alles andere wartet, bis die Übertragung fertig ist.
• Fließen timeout Sekunden lang (Standard 120) keine Daten oder bricht die Verbindung ab, scheitert die Anfrage mit „No disk present“; DOS bietet dann Wiederholen an. Abgebrochene Downloads setzt der Worker selbst an der Abbruchstelle fort. Eine laufende Übertragung lässt sich mit Break abbrechen (Status zeigt die Nummer von amicloud-worker).
• Scheitert beim Schließen einer geänderten Datei das Hochladen, meldet Close() einen Fehler, und der Inhalt liegt in T:AmiCloud-unsaved/ – so geht nichts verloren.
• Ein nicht leeres Verzeichnis lässt sich nicht direkt löschen; Delete … ALL funktioniert (DOS löscht Eintrag für Eintrag).
• Info AMICLOUD: zeigt die Belegung des eigenen Kontos: bei einem Speicherkontingent dessen Größe, sonst belegt plus freier Platz auf dem Server. Die Zahlen kommen mit dem nächsten Verzeichnislesen und sind bis zu 30 Sekunden alt; vorher (und bei älteren Servern) erscheint eine feste Kapazität. Manche alten Programme rechnen den freien Platz in 32 Bit und zeigen über 4 GB falsch an.
• Ist das Kontingent voll, scheitert das Schreiben mit „Disk full“.
• Ein Laufwerk, kein Diskwechsel, kein Formatieren, kein Umbenennen des Datenträgers.
• Eine Datei zu ändern braucht so viel freien Speicher, wie sie groß ist (nur lesen nicht).
• Eine Datei namens debuglog im Wurzelverzeichnis der Cloud ist über AMICLOUD: nicht erreichbar (der Name ist für die Diagnose reserviert, siehe Fehlersuche).

14. Fehlersuche

15. Deinstallation

Amiga: in der Installationsschublade Execute Uninstall-AmiCloud. Das Skript löscht die Programme aus C:, SYS:Tools, SYS:Prefs und L:, den DOSDriver und HELP:AmiCloud.guide; die Konfiguration nur nach Rückfrage. Ein gemountetes AMICLOUD: verschwindet erst mit dem nächsten Neustart. Von Hand:

Delete C:amicloud C:amicloud-shell C:amicloud-sync
Delete SYS:Tools/amicloud-commander SYS:Prefs/AmiCloudPrefs
Delete L:amicloud-handler L:amicloud-worker
Delete DEVS:DOSDrivers/AMICLOUD HELP:AmiCloud.guide
Delete ENV:amicloud.cfg ENVARC:amicloud.cfg     ; nur wenn gewünscht

PC: amicloud, amicloud-shell, amicloud-sync, amicloud-commander aus dem Installationsverzeichnis und ggf. ~/.amicloudrc löschen.

16. Bauen aus den Quellen

Die Quellen liegen auf GitHub: github.com/dangelrk/AmiCloud; die Amiga-Programme gibt es auch als Archiv auf Aminet. Die gemeinsamen Bibliotheken stecken im Projekt AmiCloudCore, das als Git-Submodul core/ eingebunden ist. Alle Einzelheiten stehen in docs/BUILD.md.

git clone --recurse-submodules https://github.com/dangelrk/AmiCloud.git
cd AmiCloud
make pc                   # PC: amicloud, amicloud-shell, amicloud-sync (libcurl)
make qt                   # PC: Qt-Commander (Qt 6, CMake)
export VBCC=/pfad/zu/vbcc
make amiga                # Amiga-Programme per vbcc -> bin/amiga/
make dist-amiga           # Installationsschublade build/dist/AmiCloud/

Nativ auf dem Amiga (vbcc, AmiSSL-, Roadshow- und MUI-SDK) im Projektverzeichnis Execute Build-Amiga; die SDK-Pfade stehen oben im Skript (AMISSL_INC, NET_INC, MUI_INC) oder werden über die Zuweisungen AmiSSL:, NetInclude:, MUI: gesetzt. Das Skript ist auf echter Hardware noch ungetestet.

17. API-Kurzreferenz und Sicherheit

Vollständige Referenz: api/API.md im Server-Paket. Basis-URL https://amicloud.example.com/api.php, HTTP Basic Auth bei jeder Anfrage. Antworten: {"status":"ok",…} bzw. {"status":"error","code":N,"message":"…"}; download liefert die Rohdaten.

• HTTPS erzwungen (außer im lokalen Testmodus AMICLOUD_ALLOW_HTTP), Zertifikatsprüfung in den Clients standardmäßig an
• Kontopasswörter nur als bcrypt-Hash in der Datenbank, App-Passwörter als SHA-256; nach 5 Fehlversuchen 15 Minuten Sperre (429)
• Öffentliche Links liefern Dateien immer als Download (nie im Browser dargestellt), bleiben im geteilten Ordner und enden bei Ablauf oder gesperrtem Eigentümer
• Speicherverzeichnis außerhalb des Web-Verzeichnisses, jeder Benutzer in eigenem Unterordner; Pfade mit .. und Sonderzeichen werden abgelehnt
• .htaccess sperrt config.php, includes/, sql/ und bin/
• Weboberfläche: Sitzungs-Cookie nur über HTTPS, SameSite=Strict, CSRF-Token in allen Formularen
• Client-seitig steht das Passwort im Klartext in amicloud.cfg bzw. ~/.amicloudrc – Datei entsprechend schützen und ein widerrufbares App-Passwort verwenden

18. Lizenz

AmiCloud – Copyright © 2026 Ronny Krueger.

AmiCloud ist freie Software. Sie dürfen es unter den Bedingungen der GNU General Public License, wie von der Free Software Foundation veröffentlicht, weitergeben und/oder verändern, entweder gemäß Version 3 der Lizenz oder (nach Ihrer Wahl) jeder späteren Version.

• Sie dürfen das Programm benutzen, kopieren und weitergeben.
• Sie dürfen es verändern und veränderte Fassungen weitergeben.
• Wer es weitergibt, muss den Quellcode mitliefern oder zugänglich machen, wieder unter der GPL.
• Es gibt keine Gewährleistung, soweit gesetzlich zulässig.

Maßgeblich ist allein der englische Lizenztext in der Datei LICENSE. Der enthaltene JSON-Parser Parson (© Krzysztof Gabis) steht unter der MIT-Lizenz; ihr Wortlaut liegt als THIRD-PARTY-NOTICES in der Installationsschublade.

19. Autor und Kontakt

AmiCloud wurde geschrieben von Ronny Krueger. Fehlermeldungen und Vorschläge: amitools@planet-rk.de. Quellen und Fehlerberichte: github.com/dangelrk/AmiCloud.

Verwandte Projekte: AmiCloudCore (gemeinsame Bibliotheken), AmiOwnCloud (OwnCloud/Nextcloud per WebDAV), AmiVCS (Versionsverwaltung).

20. Versionsgeschichte

Programme 0.10 (08.11.2026)

Alle Fenster der Amiga-Programme (Commander, AmiCloudPrefs) merken ihre Position. Commander (MUI): die Auswahl im aktiven Panel ist wieder gut zu sehen. Scheitert TLS an einer falschen Amiga-Uhr (z. B. leere RTC-Batterie), nennt die Meldung die Uhrzeit und bittet, sie zu prüfen.

Programme 0.9 (07.11.2026)

AMICLOUD: legt leere Dateien jetzt auch auf dem Server an: Copy einer leeren Datei erzeugte vorher gar nichts, und eine mit MODE_NEWFILE geleerte Datei behielt auf dem Server ihren alten Inhalt. Wird eine Datei mit SetFileSize verlängert, sind die neuen Bytes Nullen. amicloud-commander rechnet lokale Dateizeiten mit gmt_offset und dst um. Server: Löschen und gleichzeitiges Hochladen derselben Datei kommen sich nicht mehr in die Quere; Hochladen unterhalb einer Datei ergibt 409, eine ungültige Range wird ignoriert, das Web meldet ein volles Kontingent mit 507. Hinweis auf den experimentellen Status ergänzt.

Programme 0.8 (07.11.2026)

Handbuch überarbeitet. Der Installer meldet es jetzt, wenn er nicht aus seiner Schublade gestartet wird, statt mit „object in use“ abzubrechen.

Programme 0.7 (02.11.2026)

Namen, die sich nur in Groß-/Kleinschreibung unterscheiden (auch Umlaute): AMICLOUD: zeigt den zweiten als name_2, jeder führt zu seiner Datei; Abgleich, get -r/get mit Muster und die Commander holen solche Namen nicht, sondern melden sie. Commander: Verschieben löscht die Quelle nur noch nach erfolgreicher Kopie. AmiCloud Desktop: ab macOS 26.

Programme 0.6 (02.11.2026)

Keine Änderungen an den Programmen; die Versionsnummer folgt dem gemeinsamen Release mit AmiOwnCloud und AmiVCS.

Programme 0.5 (01.11.2026)

Wird eine Anmeldung abgelehnt (falsches Passwort), versuchen es die Programme mit denselben Zugangsdaten 15 Minuten lang nicht erneut und melden den Fehler sofort. Vorher konnte ein Zugriff nach dem anderen die Sperre des Servers gegen zu viele Fehlversuche auslösen und immer weiter verlängern.

Programme 0.4 (01.11.2026)

AMICLOUD:: SetDate und Copy CLONE übernehmen das Datum (vorher wurde daraus immer der 01.01.1978). Der Server liegt dem Amiga-Archiv bei (Schublade Server).

Programme 0.3 (01.11.2026)

Umlaute in Dateinamen (über codesets.library, sonst ISO-8859-1); Leerzeichen und Sonderzeichen in Pfaden. Abgleich: bei Konflikten bleiben beide Fassungen erhalten, Rückfrage vor dem Löschen vieler Dateien, optionale Virenprüfung über xvs.library, schneller bei großen Ordnern (Änderungsliste des Servers). Neu: AmiCloud Desktop für macOS. Server: Änderungsliste seitenweise und mit Umbenennungen (Migration 006).

Programme 0.2 (31.10.2026)

Abgleich (amicloud-sync) sicherer: Abbruch bei Lesefehlern, Ctrl-C ohne Löschungen, kein leeres Neuanlegen eines verschwundenen Server-Ordners, Upload nur auf den beim Abgleich gesehenen Stand; zu lange und nur in der Schreibung verschiedene Namen werden übersprungen. Ortszeit für lokale Dateien. Mindestens 68020. Server: Upload mit Bedingung (if_revision, create_only).

Programme 0.1 (2026)

Erste Fassung: Server mit REST-API und Weboberfläche, amicloud, amicloud-shell, amicloud-commander (MUI und Qt), amicloud-sync, AmiCloudPrefs und der AMICLOUD:-Handler; Suche in allen Programmen; Keep-Alive-Verbindungen auf dem Amiga. Benutzerverwaltung, App-Passwörter, Speicherkontingente und öffentliche Links; Weboberfläche im Stil von ownCloud; quota in CLI und Shell, Belegung in den Commander-Statuszeilen und bei Info AMICLOUD:. Für langsame Verbindungen: Timeouts nur bei Stillstand (timeout), Fortsetzen abgebrochener Downloads, Ctrl-C bricht ab, AMICLOUD: bleibt während einer Übertragung bedienbar.

Handbuch 1.5 (08.11.2026)

Quellen und Fehlerberichte auf GitHub verlinkt.

Handbuch 1.3 (07.11.2026)

Mindestprozessor 68020 überall genannt, Archivnamen wie auf Aminet, Quellen folgen später auf GitHub, neue Kontaktadresse, Hinweis zum Start des Installers aus der Shell.

Handbuch 1.2 (23.10.2026)

Langsame Verbindungen: timeout, cache_ttl, Ctrl-C, Fortsetzen von Downloads, T:AmiCloud-unsaved.

Handbuch 1.1 (22.10.2026)

Weboberfläche, App-Passwörter, Benutzerverwaltung, quota.

Handbuch 1.0 (27.09.2026)

Neu geschrieben für das eigenständige Projekt AmiCloud mit Installationsschublade, Install-AmiCloud und Uninstall-AmiCloud.