Instalación

Rayforge está disponible para Linux y Windows. Elige tu plataforma a continuación y sigue las instrucciones de instalación.

Seleccione su sistema operativo:

Elija el método de instalación:

Paquete Snap

El paquete Snap funciona en la mayoría de distribuciones Linux e incluye todas las dependencias en un entorno aislado.

Instalar Rayforge

sudo snap install rayforge

Conceder permisos (¡Importante!)

Permisos requeridos

La versión Snap se ejecuta en un sandbox y requiere concesión manual de permisos para acceso al hardware.

Para acceso al puerto serie USB:

# 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

Para acceso a la cámara:

sudo snap connect rayforge:camera

Verificar permisos

snap connections rayforge

Busque serial-port en la lista. Si muestra "conectado", está listo.

Verificar instalación

✓

Iniciar Rayforge

Inicie Rayforge desde el menú de aplicaciones o terminal. Debería ver la ventana principal con el lienzo y la barra de herramientas.

✓

Verificar versión

Compruebe Ayuda - Acerca de para confirmar la versión instalada.

✓

Conectar su máquina

Conecte su controlador láser vía USB y verifique que el puerto serie aparezca en la configuración de máquina de Rayforge.

tip

En Linux, los controladores láser suelen aparecer como /dev/ttyUSB0 o /dev/ttyACM0.

Solución de problemas

¿Problemas de permisos?

Si su dispositivo no es detectado, consulte la Guía de permisos Snap. Guía de permisos Snap

¿El puerto serie sigue sin funcionar?

Volver a conectar el dispositivo USB: Desconecte su controlador láser, espere 5 segundos y vuelva a conectarlo.
Reiniciar Rayforge: Cierre completamente y vuelva a iniciar.
Compruebe que el dispositivo existe:
```
ls -l /dev/ttyUSB* /dev/ttyACM*
```

Reinstalar si es necesario:

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

¿Necesita ayuda?

Para ayuda adicional, informe de un problema en GitHub o únase a nuestro Discord. GitHub | Discord

Siguientes Pasos

Ahora que Rayforge está instalado, continúa con Configuración Inicial para configurar tu máquina.