Skip to content

Installation

JanHG98 edited this page Oct 16, 2026 · 5 revisions

Installation

Aktueller Stand 16.10.2026

Verbindlich: main@8fb581b730f7a3833566c4bbb7c87875ad921e69; veröffentlicht bleibt v1.9.0. PR #74–#97 sind integriert. Deployment/Discovery, Imagebuilder, Pi-VPN und Syslog sind auf main, nicht mehr nur historische Vorschau. 26 reguläre Rollen einschließlich Deployment-VM; Provisioning ist optional zusätzlich.

Betreiberbestätigt: KDE-Boot, Rufe, SDS, Aufnahme/RF-Wiedergabe und WLAN am 13.10.; 28/28 Discovery-Agenten aktualisiert und keine ungeklärten Remote-Aufträge mehr am 15.10. Ein aktueller Backend-Gesamtrollout, NAS-Entlastung, SIP/Telegram, VPN-Wechsel und Dauerlauf bleiben separat offen. Vier alte Git-/Timeoutfehler bleiben Fehler.

Gesamtroadmap · Upstream-Vergleich · Roadmap und Releases. NETCORE-IAM-01 ist weiterhin Planung; AD-SSO-Pilot und Gruppenmapping sind konkretisiert, Produkt-/Betriebsentscheidung und Umsetzung offen.

Aktuelle Fachanleitung und Grenzen. Die bestätigte Pi-Kurzabnahme gilt nur für den dokumentierten Build und Funktionsumfang; sie ist keine generelle Mehrzellen-, SIP-, VPN- oder Dauerlaufabnahme.

Historischer Seitenstand bis 07.10.2026

Die folgende frühere Fassung bleibt als datierte Historie erhalten. Frühere Dienstzahlen, Featurebranch-Aussagen, offene Tests und Prioritäten sind keine aktuelle Statusaussage; heutige Verfahren stehen oben beziehungsweise in den verlinkten kanonischen Docs.

Installation der lokalen Basisstation

Aktueller Quellenstand 07.10.2026: main 990bffb2; Release weiterhin v1.9.0. PR #59 mit Hell/Dunkel ist integriert, PR #60 ergänzt Projektarchive. Nur main ist als Branch vorhanden. Deployment/Discovery, Imagebuilder, Pi-VPN und neuere Syslog-Pipeline bleiben ausschließlich am historischen Featurecommit bbf0397 vorhanden. Keine neue Live-Abnahme. Roadmap und Releases · Upstream-Vergleich

Aktueller Updateweg

PR #59 ist auf main; der frühere Branch feat/netcore-dashboard-design existiert nicht mehr. Alte Branchwechsel in den TBS- und Dienstanleitungen durch einen geprüften main-/SHA-Checkout ersetzen. Aktive Unit, ExecStart, Binary- und Konfigurationspfad erfassen; lokale Änderungen, Konfiguration und vorherige Binary sichern. Erst erfolgreich bauen, dann gezielt installieren und Fachfunktion prüfen.

Für das reine TBS-Designupdate MIGRATE_LOCAL_TTS_CONFIG=0 und DISABLE_LOCAL_PIPER=0 verwenden. Dienst-Updater können zusätzliche Konfigurationen verändern; gezielte Binary-/Python-Updates gemäß tatsächlicher Unit bevorzugen. Rückweg über die gesicherte passende Binary und den dokumentierten früheren Quell-SHA, ohne aktuelle Konfiguration pauschal zu überschreiben. Ein Checkout allein aktualisiert keinen installierten Dienst.

Diese Anleitung beschreibt eine quellbasierte TBS-Installation auf Debian/Raspberry Pi OS. Sie installiert keine der 25 Backend-LXCs. Die lokale Umgebung muss zu Hardware, Treiber, Codec und Konfiguration passen. Für einen großen Aufbau anschließend Open-Lab-Deployment lesen.

1. System und SDR vorbereiten

  • 64-Bit-Linux, ausreichend RAM/Storage, stabile Versorgung und Zeitquelle;
  • Rust/Cargo mit Unterstützung für Edition 2024, C/C++-Toolchain, pkg-config;
  • SoapySDR und passender konkreter SDR-Treiber; native Codec-Abhängigkeiten für Default-Build mit Asterisk/Audio;
  • ffmpeg für Medien-/TTS-Pfade, Netzwerkzugriff zu bewusst aktivierten Diensten.
sudo apt update
sudo apt install -y git curl build-essential pkg-config cmake clang libsoapysdr-dev soapysdr-tools ffmpeg
SoapySDRUtil --find
SoapySDRUtil --probe="driver=<DEIN-TREIBER>"

Die Cargofeatures sind in bins/bluestation-bs/Cargo.toml definiert; der Default-Build enthält asterisk, recording und audio-player. Falls eine native Codec-Bibliothek fehlt, ist ein erfolgreich gebautes Minimal-Binary nicht gleichbedeutend mit aktivierter SIP-/Audiofunktion. Common-Build-Errors

2. Quellcode und lokalen Stand sichern

git clone https://github.com/JanHG98/netcore-tetra.git /opt/netcore-tetra
cd /opt/netcore-tetra
git status --short --branch
git rev-parse HEAD

Für eine bereits bestehende Installation keinen neuen Clone über Daten und lokale Änderungen schreiben. Vor Updates Branch/Commit, Konfiguration, Units und Persistenz sichern. Backup-and-Fallback

3. TBS-Konfiguration erstellen

cp Docs/basisstation.config.sanitized.example.toml config.local.toml
chmod 600 config.local.toml
python3 -c 'import pathlib,tomllib; tomllib.loads(pathlib.Path("config.local.toml").read_text()); print("TOML OK")'

Die Datei ist nur ein syntaktisch lesbares Beispiel. Die markierten Werte für SDR, Funk, Netz, Directory, SIP, Brew, Control Room und Zugangsdaten gegen den echten Standort prüfen; ungenutzte Integrationen deaktivieren. Die TOML-Syntaxprüfung ersetzt nicht die Laufzeitvalidierung. Falls [control_room] für das verteilte Backend aktiviert wird: host auf den Node Gateway setzen und endpoint_path = "/ws/node". Configuration · Netzwerk-und-Ports

4. Bauen und zuerst manuell starten

cd /opt/netcore-tetra
cargo build --release -p bluestation-bs
RUST_LOG=info ./target/release/bluestation-bs ./config.local.toml

Bei fehlenden nativen Default-Abhängigkeiten lässt sich für einen bewusst eingeschränkten Test cargo build --release -p bluestation-bs --no-default-features verwenden. Für den gewünschten Audio-/SIP-Betrieb müssen die Features später korrekt gebaut werden. Vor dem Senden RF-Kette messen und Betriebsvoraussetzungen prüfen. Beim Start auf Konfigurations-Fallback, SDR-Identität, RX/TX-Center, Sample-Rate, Downlink und Time-Skips achten. Danach Registrierung, SDS, Ruf, Release und Dashboard testen. Hardware-und-RF · Abnahme

5. Systemd erst nach dem manuellen Test

Die getestete Binärdatei an einen festen Ort installieren, Konfiguration nach /etc/netcore/ übernehmen und den Dienstbenutzer passend für SDR, Audio- und Cache-Pfade berechtigen. Die Beispiel-Unit unter Systemd-Service an diese echten Pfade anpassen. Nicht gleichzeitig einen manuellen und einen systemd-TBS-Prozess mit denselben RF- und Dashboard-Ressourcen starten.

6. Weitere Komponenten

Bedarf Weiterführende Seite
25 Backend-LXCs Open-Lab-Deployment
Directory-Namen/Status NetCore-Directory
Teilnehmer/Gruppen Provisioning
TTS/Medien Audio-Zentrale
Telefonie SIP-und-Brew
Leitstelle Control-Room

v1.9.0: Der aktuelle Release enthält die TBS-CMCE-Handler für den Warnversand und die obligatorische Frame-18-BNCH-Korrektur. Für den Quellbuild möglichst Cargo.lock mit --locked verwenden. Die Warnzentrale selbst ist ein Python-Dienst; ihre Einrichtung steht auf Warnzentrale. Historische Git-Stände: Roadmap und Releases.

Entwicklungsvorschau vom 28 September 2026

Entwicklungsvorschau vom 28.09.2026: Historischer Featurecommit bbf0397, Deployment-Komponente 0.2.3. Diese Funktionen sind noch nicht auf main und kein neuer Gesamtrelease. PR #57 wurde in den Entwicklungsbranch gemergt. Die Ubuntu-VM kann im historischen Featurestand ein vorgebautes Pi-Image erzeugen. Für diese zusätzliche Installationsart gilt Deployment und Discovery einschließlich Pinning, Standortprofil, Soapy-Probe und offener Hardwareabnahme. Die obige Anleitung bleibt die main-Quellinstallation.

Clone this wiki locally