crabSDR

Sysop-Handbuch eine crabSDR-Station betreiben

Für Funkamateure, die mit Erlaubnis von DO1XX eine crabSDR-Station betreiben.

Inhalt: Einrichten · Erste Anmeldung · Die Admin-Seite · Station · Bänder · Decoder · Benutzer · Erreichbar machen und Verzeichnis · Streams · Aktualisieren und Sichern · Probleme · Regeln

Sysop guide running a crabSDR station

For radio amateurs who run a crabSDR station with permission from DO1XX.

Contents: Setup · First sign-in · The admin page · Station · Bands · Decoders · Users · Going public and directory · Streams · Updating and backing up · Troubleshooting · Rules

Einrichten

crabSDR läuft als Docker-Container auf einem Linux-Rechner (PC, Laptop oder Raspberry Pi 4/5 mit 64-Bit-System) mit einem SDR-Empfänger: RTL-SDR-Stick, Mirics MSi2500 („MSI SDR“), HackRF, Airspy, Airspy HF+, PlutoSDR, USRP, RX888 oder andere SoapySDR-Geräte. Die Installation steht Schritt für Schritt auf crabsdr.de/docker: Docker installieren, Kernel-Treiber sperren, an der Registry anmelden, Compose-Datei, Starten.

Alles, was die Station speichert, liegt im Ordner ./data neben der Compose-Datei: config.toml (alle Einstellungen), Benutzer, Chat, Decoder-Ergebnisse und der Schlüssel fürs Relais.

Setup

crabSDR runs as a Docker container on a Linux computer (PC, laptop, or Raspberry Pi 4/5 with a 64-bit system) with an SDR receiver: RTL-SDR dongle, Mirics MSi2500 (“MSI SDR”), HackRF, Airspy, Airspy HF+, PlutoSDR, USRP, RX888, or other SoapySDR devices. The installation is described step by step at crabsdr.de/docker: install Docker, block the kernel drivers, sign in to the registry, compose file, start.

Everything the station stores lives in the folder ./data next to the compose file: config.toml (all settings), users, chat, decoder results, and the key for the relay.

Erste Anmeldung

docker compose logs | grep Passwort

Dort steht beim ersten Start das Passwort des Kontos admin. Damit unter http://<rechner>:8080/admin/ anmelden; danach verlangt die Seite ein eigenes Passwort (mindestens 10 Zeichen, am besten ein Satz). Passwort vergessen:

docker compose run --rm --entrypoint crabsdr-server crabsdr --reset-admin /data/config.toml

Die Admin-Seite ist nur im eigenen Netz erreichbar; über <name>.crabsdr.de nur mit [relay] admin = true.

First sign-in

docker compose logs | grep Passwort

On the first start, this shows the password of the admin account. Use it to sign in at http://<computer>:8080/admin/; the page then asks you for a password of your own (at least 10 characters, ideally a sentence). Forgot the password:

docker compose run --rm --entrypoint crabsdr-server crabsdr --reset-admin /data/config.toml

The admin page is reachable only on your own network; via <name>.crabsdr.de only with [relay] admin = true.

Die Admin-Seite

Speichern und Neustart: Fast jede Änderung wirkt erst nach einem Neustart. Nach dem Speichern erscheint oben ein Hinweis mit „Jetzt neu starten“; die Hörer sind dann einige Sekunden getrennt. Gespeichert wird nur, was die Prüfung besteht, die vorige Fassung bleibt als Sicherung.

The admin page

Saving and restarting: Almost every change takes effect only after a restart. After saving, a note with “Restart now” appears at the top; listeners are then disconnected for a few seconds. Only what passes the check is saved; the previous version is kept as a backup.

Station

Station

Bänder

Ein Band ist ein Empfänger mit eigenem Wasserfall. Neu anlegen unter „Band hinzufügen“ oder im Reiter „Sticks“ mit „als Band anlegen“ (dort sind die Geräteangaben schon richtig). Jede Karte hat ein aufklappbares Feld „Quelle“.

Mirics MSi2500: Wer diesen Treiber wählt, bekommt die erprobten Werte von DF0HHH eingetragen: ZF-Filter 1,536 MHz, USB-Übertragung BULK, Stufen LNA 0, Mixer 19, Mixbuffer 0, Baseband 35. Übersteuert es (Rauschteppich hoch, Geisterträger): Baseband kleiner. Zu leise: LNA 24 probieren. Der ZF-Filter sollte etwas kleiner sein als die Abtastrate. Zwei MSi am selben Rechner: Im Reiter „Sticks“ steht für jeden die genaue Angabe (driver=soapyMiri,serial=…); die Sticks dann nicht mehr umstecken.

RX888: ein Gerät für die ganze Kurzwelle. Im Reiter „Sticks“ „als Band anlegen“ – auf Wunsch kommen die Amateurfunkbänder 160–10 m gleich als Unterbereiche dazu. Die Abtastrate ist 32 MS/s (0–32 MHz, nutzbar 1,6–30,4 MHz), die Mitte steht fest bei 16 MHz. Verstärkung: ein Wert in dB, oder einzeln RF (Dämpfung −31,5…0) und IF (−24,6…+33). Braucht einen PC mit USB 3 und AVX2, keinen Raspberry Pi. In der Compose-Datei statt devices: den USB-Ordner einbinden, weil sich der RX888 nach dem Firmware-Laden neu anmeldet:

volumes: ["./data:/data", "/dev/bus/usb:/dev/bus/usb"]
device_cgroup_rules: ["c 189:* rmw"]

Vor den Eingang gehört ein 30-MHz-Tiefpass, sonst kommen starke Sender über 32 MHz (UKW) in die Kurzwelle.

USRP: Treiber „andere über SoapySDR“, Gerät driver=uhd. Einmal die FPGA-Images laden: docker compose exec crabsdr uhd_images_downloader -t b2xx (B200/B210). Compose-Datei wie beim RX888. PlutoSDR: driver=plutosdr am USB oder driver=plutosdr,hostname=… übers Netz.

RTL-Sticks: Mehrere gleiche Sticks bekommen im Reiter „Sticks“ eine eigene Seriennummer (z. B. „2m“, „70cm“), dann findet crabSDR jeden an jedem USB-Anschluss wieder.

Unterbereich: Beim Hinzufügen „Quelle: Unterbereich von …“ wählen – ein eigener Reiter aus einem breiten Empfänger, z. B. 40 m aus einem Kurzwellen-Band. Die Breite muss die Rate des Geräts ganzzahlig teilen. Besonders sparsam sind Breiten, die auch die FFT teilen (beim RX888 250, 500, 1000 oder 2000 kHz): die schneidet crabSDR direkt aus dem Wasserfall des Geräts. Unterbereiche stehen auf der Admin-Seite eingerückt unter ihrem Gerät und in der config.toml als [[bands.sub]] darunter. parent = … geht auch; der Knopf „Unter ihr Gerät schreiben“ schreibt es als [[bands.sub]].

Bands

A band is a receiver with its own waterfall. Create a new one under “Add band” or in the “Dongles” tab with “create as band” (there, the device details are already correct). Each card has an expandable “Source” field.

Mirics MSi2500: If you pick this driver, the proven values from DF0HHH are filled in: IF filter 1.536 MHz, USB transfer BULK, stages LNA 0, Mixer 19, Mixbuffer 0, Baseband 35. If it overloads (high noise floor, ghost carriers): lower Baseband. Too quiet: try LNA 24. The IF filter should be slightly narrower than the sample rate. Two MSi on the same computer: the “Dongles” tab shows the exact device string for each (driver=soapyMiri,serial=…); after that, do not swap the dongles around anymore.

RX888: one device for all of shortwave. In the “Dongles” tab, “create as band” – on request, the amateur radio bands 160–10 m are added right away as sub-ranges. The sample rate is 32 MS/s (0–32 MHz, usable 1.6–30.4 MHz), the center is fixed at 16 MHz. Gain: one value in dB, or separately RF (attenuation −31.5…0) and IF (−24.6…+33). Needs a PC with USB 3 and AVX2, not a Raspberry Pi. In the compose file, mount the USB folder instead of devices:, because the RX888 re-enumerates after loading its firmware:

volumes: ["./data:/data", "/dev/bus/usb:/dev/bus/usb"]
device_cgroup_rules: ["c 189:* rmw"]

A 30 MHz low-pass filter belongs in front of the input; otherwise strong transmitters above 32 MHz (FM broadcast) alias into shortwave.

USRP: driver “others via SoapySDR”, device driver=uhd. Load the FPGA images once: docker compose exec crabsdr uhd_images_downloader -t b2xx (B200/B210). Compose file as for the RX888. PlutoSDR: driver=plutosdr on USB or driver=plutosdr,hostname=… over the network.

RTL dongles: Several identical dongles each get their own serial number in the “Dongles” tab (e.g. “2m”, “70cm”); then crabSDR finds each one again on any USB port.

Sub-range: When adding, pick “Source: sub-range of …” – a separate tab cut from a wide receiver, e.g. 40 m from a shortwave band. The width must divide the device’s rate evenly. Especially cheap are widths that also divide the FFT (on the RX888: 250, 500, 1000, or 2000 kHz): crabSDR cuts those directly from the device’s waterfall. Sub-ranges are listed on the admin page indented under their device and in config.toml as [[bands.sub]] below it. parent = … works too; the button “Write under its device” writes it as [[bands.sub]].

Decoder

Decoder hören ständig auf einer Frequenz mit, auch wenn niemand zuhört. Ergebnisse erscheinen auf der Seite Digital. Hinzufügen im Reiter „Decoder“: Plugin und Frequenz, das Band ergibt sich aus der Frequenz. „öffentlich“ aus = Ergebnisse nur für Admins und zugeteilte Mitglieder.

Empfangsberichte an PSKReporter und wsprnet (FT8, FT4, WSPR) im Reiter „Konfiguration“ einschalten:

[spots]
enabled = true
call = "DL1ABC"
antenna = "Dipol, 10 m hoch"

Ein Raspberry Pi 4 trägt zwei Bänder mit APRS und FT8. Wird er heiß (über 75 °C) oder langsam: Decoder oder Bänder reduzieren, FT8 mit depth = 2.

Decoders

Decoders listen on a frequency all the time, even when nobody is listening. Results appear on the Digital page. Add them in the “Decoders” tab: plugin and frequency; the band follows from the frequency. “public” off = results only for admins and assigned members.

Reception reports to PSKReporter and wsprnet (FT8, FT4, WSPR) are enabled in the “Configuration” tab:

[spots]
enabled = true
call = "DL1ABC"
antenna = "Dipole, 10 m up"

A Raspberry Pi 4 carries two bands with APRS and FT8. If it gets hot (above 75 °C) or slow: reduce decoders or bands, FT8 with depth = 2.

Benutzer und Zugang

Ohne weitere Konten hört jeder alle öffentlichen Bänder. Mit Konten (Reiter „Benutzer“, Rolle Nutzer oder Admin) bekommen Mitglieder zusätzlich die ihnen zugeteilten Mitglieder-Bänder und nicht öffentlichen Decoder; sie melden sich auf der Hören-Seite an. Sperren, Passwort zurücksetzen und Löschen gehen jederzeit; der letzte Admin bleibt immer erhalten.

Users and access

Without additional accounts, everyone hears all public bands. With accounts (“Users” tab, role user or admin), members additionally get the member bands assigned to them and the non-public decoders; they sign in on the Listen page. Blocking, resetting the password, and deleting are possible at any time; the last admin is always kept.

Erreichbar machen und ins Verzeichnis

Über das Relais von crabsdr.de ist die Station unter https://<name>.crabsdr.de erreichbar – ohne eigene Domain, Portfreigabe oder VPN, auch hinter LTE. Die Station baut dafür nur eine ausgehende Verbindung auf.

1. Reiter „Station“: „Über crabsdr.de erreichbar machen“ einschalten, Wunschname eintragen (3–32 Zeichen a–z, 0–9, -; gern das Rufzeichen), speichern, neu starten.
2. Der Zustand steht dann auf „wartet auf Freigabe“. DO1XX gibt den Namen frei; danach verbindet sich die Station von selbst (Zustand „verbunden“, mit Link).
3. „Im Verzeichnis listen“ einschalten und mindestens ein Band auf „öffentlich“ stellen. Nach etwa 5 Minuten steht die Station auf crabsdr.de.

Im eigenen Netz bleibt die Station unter http://<rechner>:8080 erreichbar. Abschalten geht jederzeit mit demselben Schalter.

Going public and into the directory

Via the crabsdr.de relay, the station is reachable at https://<name>.crabsdr.de – without your own domain, port forwarding, or VPN, even behind LTE. The station only opens an outgoing connection for this.

1. “Station” tab: enable “Make reachable via crabsdr.de”, enter the desired name (3–32 characters a–z, 0–9, -; ideally the call sign), save, restart.
2. The state then shows “waiting for approval”. DO1XX approves the name; after that, the station connects by itself (state “connected”, with a link).
3. Enable “List in the directory” and set at least one band to “public”. After about 5 minutes, the station is listed on crabsdr.de.

On your own network, the station remains reachable at http://<computer>:8080. You can switch it off at any time with the same switch.

Streams

Jede Frequenz gibt es auch als Stream für VLC und andere Spieler, z. B. https://<name>.crabsdr.de/stream/145500/fm.ogg, mit ?anim=1 samt animierter Krabbe. Alle Adressen und Parameter: crabsdr.de/stream-technik.html.

Streams

Every frequency is also available as a stream for VLC and other players, e.g. https://<name>.crabsdr.de/stream/145500/fm.ogg, with ?anim=1 including an animated crab. All addresses and parameters: crabsdr.de/stream-technik.html.

Aktualisieren und Sichern

docker compose pull && docker compose up -d

Was sich geändert hat, steht unter crabsdr.de/changelog (auch als Atom-Feed crabsdr.de/changelog.atom); gibt es eine neuere Version als die laufende, zeigt die Admin-Seite der Station das oben als grüne Leiste. Der Befehl holt die neueste Version; Einstellungen und Daten in ./data bleiben. Eine bestimmte Version festhalten oder zu ihr zurückkehren: in der Compose-Datei z. B. image: registry.crabsdr.de/crabsdr:1.6.0-52. Zum Sichern genügt der Ordner ./data (am besten bei gestopptem Container).

Alte Schlüsselnamen (z. B. [[sdrs]], sdr_driver) sind ein Fehler, die Station startet damit nicht. Deshalb nach docker compose pull und vor up -d prüfen; die Meldung nennt den neuen Namen:

docker compose run --rm --entrypoint crabsdr-server crabsdr --check /data/config.toml

Updating and backing up

docker compose pull && docker compose up -d

What has changed is listed at crabsdr.de/changelog (also as an Atom feed crabsdr.de/changelog.atom); if there is a newer version than the one running, the station’s admin page shows this as a green bar at the top. The command fetches the latest version; settings and data in ./data are kept. To pin a particular version or go back to it: in the compose file, e.g. image: registry.crabsdr.de/crabsdr:1.6.0-52. For a backup, the ./data folder is all you need (ideally with the container stopped).

Old key names (e.g. [[sdrs]], sdr_driver) are an error; the station will not start with them. So after docker compose pull and before up -d, run the check; the message names the new key:

docker compose run --rm --entrypoint crabsdr-server crabsdr --check /data/config.toml

Probleme

Troubleshooting

Regeln

• crabSDR ist für den Amateurfunk. Lizenz: PolyForm Noncommercial 1.0.0 – nicht kommerzielle Nutzung ist erlaubt, kommerzielle nicht. Quelltext zum Selbstbauen: crabsdr.de/quellen.
• Die Zugangsdaten zur Registry nicht weitergeben. Wer ein Konto möchte, meldet sich bei DO1XX.
• Fragen und Fehler: info@crabsdr.de

Rules

• crabSDR is for amateur radio. Licence: PolyForm Noncommercial 1.0.0 – noncommercial use is allowed, commercial use is not. Source code to build it yourself: crabsdr.de/quellen.
• Do not pass on the registry credentials. Anyone who wants an account should contact DO1XX.
• Questions and bugs: info@crabsdr.de