Installation

Rayforge ist für Linux, Windows und macOS verfügbar. Wähle deine Plattform unten und folge den Installationsanweisungen.

Wähle dein Betriebssystem:

Wähle die Installationsmethode:

Snap-Paket

Das Snap-Paket funktioniert auf den meisten Linux-Distributionen und enthält alle Abhängigkeiten in einer Sandbox-Umgebung.

Rayforge installieren

sudo snap install rayforge

Benutzer zur Dialout-Gruppe hinzufügen

Berechtigungen erforderlich

Auf Debian-basierten Distributionen muss dein Benutzer in der dialout-Gruppe sein, auch bei Verwendung von Snap, um AppArmor DENIED-Meldungen zu vermeiden.

sudo usermod -a -G dialout $USER

Wichtig: Melde dich ab und wieder an, damit diese Änderung wirksam wird.

Berechtigungen erteilen (Wichtig!)

Für USB-Seriell-Zugriff:

# Enable experimental hotplug support (one-time setup)
sudo snap set system experimental.hotplug=true

# Connect your laser via USB, then grant access
sudo snap connect rayforge:serial-port

Für Kamerazugriff:

sudo snap connect rayforge:camera

Berechtigungen überprüfen

snap connections rayforge

Suche nach serial-port in der Liste. Wenn "connected" angezeigt wird, bist du bereit.

Installation überprüfen

✓

Rayforge starten

Starte Rayforge aus deinem Anwendungsmenü oder Terminal. Du solltest das Hauptfenster mit der Arbeitsfläche und der Symbolleiste sehen.

✓

Version überprüfen

Prüfe Hilfe - Über, um die installierte Version zu bestätigen.

✓

Deine Maschine verbinden

Verbinde deinen Laser-Controller über USB und überprüfe, ob der Seriell-Port in den Maschineneinstellungen von Rayforge angezeigt wird.

tipp

Unter Linux erscheinen Laser-Controller typischerweise als /dev/ttyUSB0 oder /dev/ttyACM0.

Fehlerbehebung

Berechtigungsprobleme?

Wenn Ihr Gerät nicht erkannt wird, siehe den Snap-Berechtigungsleitfaden. Snap-Berechtigungsanleitung

Seriell-Port funktioniert immer noch nicht?

USB-Gerät neu anschließen: Trenne deinen Laser-Controller, warte 5 Sekunden und schließe ihn wieder an.
Rayforge neu starten: Schließe vollständig und starte neu.
Überprüfe, ob das Gerät existiert:
```
ls -l /dev/ttyUSB* /dev/ttyACM*
```

Falls erforderlich neu installieren:

sudo snap remove rayforge
sudo snap install rayforge
sudo snap connect rayforge:serial-port

Hilfe benötigt?

Für weitere Hilfe melde ein Problem auf GitHub oder trete unserem Discord bei. GitHub | Discord

Nächste Schritte

Nachdem Rayforge installiert ist, fahre mit Ersteinrichtung fort, um deine Maschine zu konfigurieren.