Instalação

O Rayforge está disponível para Linux, Windows e macOS. Escolha sua plataforma abaixo e siga as instruções de instalação.

Selecione seu sistema operacional:

Escolha o método de instalação:

Pacote Snap

O pacote Snap funciona na maioria das distribuições Linux e inclui todas as dependências em um ambiente isolado.

Instalar Rayforge

sudo snap install rayforge

Adicionar Usuário ao Grupo dialout

Permissões Necessárias

Em distribuições baseadas em Debian, seu usuário deve estar no grupo dialout mesmo ao usar Snap, para evitar mensagens AppArmor DENIED.

sudo usermod -a -G dialout $USER

Importante: Saia e entre novamente para que esta alteração tenha efeito.

Conceder Permissões (Importante!)

Para Acesso à Porta Serial 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 Acesso à Câmera:

sudo snap connect rayforge:camera

Verificar Permissões

snap connections rayforge

Procure por serial-port na lista. Se mostrar "connected", você está pronto.

Verificar Instalação

✓

Iniciar Rayforge

Inicie o Rayforge no menu de aplicativos ou terminal. Você verá a janela principal com a área de trabalho e a barra de ferramentas.

✓

Verificar Versão

Verifique Ajuda - Sobre para confirmar a versão instalada.

✓

Conectar Sua Máquina

Conecte seu controlador de laser via USB e verifique se a porta serial aparece nas configurações de máquina do Rayforge.

dica

No Linux, os controladores de laser geralmente aparecem como /dev/ttyUSB0 ou /dev/ttyACM0.

Solução de Problemas

Problemas de permissão?

Se o seu dispositivo não for detectado, consulte o Guia de Permissões Snap. Guia de Permissões Snap

Porta serial ainda não funciona?

Reconecte o dispositivo USB: Desconecte seu controlador de laser, espere 5 segundos, conecte novamente.
Reiniciar Rayforge: Feche completamente e reinicie.
Verifique se o dispositivo existe:
```
ls -l /dev/ttyUSB* /dev/ttyACM*
```

Reinstale se necessário:

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

Precisa de Ajuda?

Para ajuda adicional, relate um problema no GitHub ou entre em nosso Discord. GitHub | Discord

Requisitos do Sistema

Recurso	Instalado	Recomendado
Espaço em disco	< 1 GB	Varia pelo projeto
RAM	1 GB	Varia pelo projeto

Os requisitos reais de disco e memória dependem da complexidade do projeto. Projetos simples podem precisar de pouco além do instalado, enquanto projetos complexos podem facilmente consumir 10 GB de RAM ou mais e exigir espaço em disco adicional significativo.

Próximos Passos

Agora que o Rayforge está instalado, prossiga para Configuração Inicial para configurar sua máquina.