Встановлення

Rayforge доступний для Linux, Windows та macOS. Виберіть свою платформу нижче та дотримуйтесь інструкцій з встановлення.

Виберіть вашу операційну систему:

Виберіть метод встановлення:

Пакет Snap

Пакет Snap працює на більшості дистрибутивів Linux і включає всі залежності в ізольованому середовищі.

Встановити Rayforge

sudo snap install rayforge

Додати користувача до групи dialout

Потрібні дозволи

На дистрибутивах на основі Debian ваш користувач повинен бути в групі dialout навіть при використанні Snap, щоб уникнути повідомлень AppArmor DENIED.

sudo usermod -a -G dialout $USER

Важливо: Вийдіть з системи і увійдіть знову, щоб ця зміна набула чинності.

Надати дозволи (Важливо!)

Для доступу до 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

Для доступу до камери:

sudo snap connect rayforge:camera

Перевірити дозволи

snap connections rayforge

Шукайте serial-port у списку. Якщо показує "підключено", ви готові до роботи.

Перевірити встановлення

✓

Запустити Rayforge

Запустіть Rayforge з меню програм або терміналу. Ви повинні побачити головне вікно з полотном і панеллю інструментів.

✓

Перевірити версію

Перевірте Допомога - Про програму, щоб підтвердити встановлену версію.

✓

Підключити вашу машину

Підключіть ваш лазерний контролер через USB і перевірте, що послідовний порт з'являється в налаштуваннях машини Rayforge.

порада

На Linux лазерні контролери зазвичай з'являються як /dev/ttyUSB0 або /dev/ttyACM0.

Виправлення проблем

Проблеми з дозволами?

Якщо ваш пристрій не виявлено, дивіться Керівництво з дозволів Snap. Керівництво з дозволів Snap

Послідовний порт все ще не працює?

Перепідключити USB пристрій: Відключіть ваш лазерний контролер, зачекайте 5 секунд, підключіть знову.
Перезапустити Rayforge: Повністю закрийте і запустіть знову.
Перевірте, що пристрій існує:
```
ls -l /dev/ttyUSB* /dev/ttyACM*
```

Перевстановіть за потреби:

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

Потрібна допомога?

Для додаткової допомоги повідомте про проблему на GitHub або приєднайтеся до нашого Discord. GitHub | Discord

Системні вимоги

Ресурс	Встановлено	Рекомендовано
Дисковий простір	< 1 ГБ	Залежить від проекту
Оперативна пам'ять	1 ГБ	Залежить від проекту

Фактичні вимоги до диска та пам'яті залежать від складності проекту. Прості проекти можуть потребувати небагато більше встановленого обсягу, тоді як складні проекти можуть легко спожити 10 ГБ оперативної пам'яті або більше та вимагати значного додаткового дискового простору.

Наступні кроки

Тепер, коли Rayforge встановлено, перейдіть до Першого налаштування, щоб налаштувати вашу машину.