Instalación

Rayforge está disponible para Linux, Windows y macOS. 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

Añadir usuario al grupo dialout

Permisos requeridos

En distribuciones basadas en Debian, tu usuario debe estar en el grupo dialout incluso al usar Snap, para evitar mensajes AppArmor DENIED.

sudo usermod -a -G dialout $USER

Importante: Cierre sesión y vuelva a iniciarla para que este cambio surta efecto.

Conceder permisos (¡Importante!)

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

Requisitos del Sistema

Recurso	Instalado	Recomendado
Espacio en disco	< 1 GB	Varía según el proyecto
RAM	1 GB	Varía según el proyecto

Los requisitos reales de disco y memoria dependen de la complejidad del proyecto. Los proyectos simples pueden necesitar poco más de lo instalado, mientras que los proyectos complejos pueden consumir fácilmente 10 GB de RAM o más y requerir un espacio en disco adicional significativo.

Siguientes Pasos

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