Установка GrigDesk

Скачайте GrigDesk с сайта и запустите приложение. Сервер и папки данных оно подготовит само.

Готовый комплект на этом сайте пока не опубликован. Собрать из исходников.

1. Скачайте комплект для Linux x64 и распакуйте архив.
2. Откройте файл GrigDesk в распакованной папке. Дождитесь первого запуска; приложение предложит добавить себя в меню.

Готово. Папка ~/.grigdesk, состояние сервера, кэш и настройки окна создаются автоматически. Создавать каталоги, копировать .env, устанавливать Node.js или регистрировать службу вручную не требуется. Файл GrigDesk и папку bin/ из комплекта оставляйте рядом.

Комплект рассчитан на настольный Linux x64 с glibc 2.28+. Если приложение не открылось из-за отсутствующих системных пакетов, выберите свою систему ниже.

Команды для дистрибутивов

Если GrigDesk уже запустился, этот раздел можно пропустить. Команды устанавливают FUSE 2 для окна, Python для терминала и OpenSSL для серверных ключей. Откройте терминал в распакованной папке комплекта, выберите систему и выполните команды.

Ubuntu 24.04+ / Debian 13 / Mint 22

sudo apt update
sudo apt install -y libfuse2t64 python3 openssl
./GrigDesk

Ubuntu 22.04 / Debian 12 / Mint 21

sudo apt update
sudo apt install -y libfuse2 python3 openssl
./GrigDesk

Fedora Workstation

sudo dnf install -y fuse fuse-libs python3 openssl
./GrigDesk

Rocky Linux 9 / AlmaLinux 9

sudo dnf install -y fuse fuse-libs python3 openssl
./GrigDesk

Arch Linux / Manjaro

sudo pacman -Syu --needed fuse2 python openssl
./GrigDesk

openSUSE Leap / Tumbleweed

sudo zypper install -y fuse libfuse2 python3 openssl
./GrigDesk

ALT Linux p10 / p11

su -c 'apt-get update && apt-get install -y fuse libfuse python3 openssl'
./GrigDesk

Для производных Ubuntu, Debian, Fedora или Arch выбирайте команды их базовой системы и версии. Это установка зависимостей для общего комплекта; отдельные пакеты GrigDesk в формате .deb или .rpm не требуются.

Сборка из исходников

В корне репозитория запустите штатный сборщик:

bin/grigdesk-ctl build

Он собирает и устанавливает сервер, интерфейс и окно, а после успеха предлагает открыть GrigDesk. Загрузку серверного runtime и рабочие папки сборщик готовит сам. При обновлении сборки закройте прежнее окно перед открытием нового.

Первая сборка: подготовка окружения и исходников

Для чистого клона нужны Git, Node.js 24 с npm и зависимости сборки. Эта подготовка выполняется перед первым bin/grigdesk-ctl build.

Системные пакеты:

Ubuntu 24.04+ / Debian 13 / Mint 22

sudo apt update
sudo apt install -y git curl ca-certificates build-essential binutils python3 xz-utils unzip libfuse2t64 openssl

Ubuntu 22.04 / Debian 12 / Mint 21

sudo apt update
sudo apt install -y git curl ca-certificates build-essential binutils python3 xz-utils unzip libfuse2 openssl

Fedora Workstation

sudo dnf install -y git curl ca-certificates gcc gcc-c++ make binutils python3 xz unzip fuse fuse-libs openssl

Rocky Linux 9 / AlmaLinux 9

sudo dnf install -y git curl ca-certificates gcc gcc-c++ make binutils python3 xz unzip fuse fuse-libs openssl

Arch Linux / Manjaro

sudo pacman -Syu --needed base-devel git curl ca-certificates python xz unzip fuse2 openssl

openSUSE Leap / Tumbleweed

sudo zypper install -y git curl ca-certificates gcc gcc-c++ make binutils python3 xz unzip fuse libfuse2 openssl

ALT Linux p10 / p11

su -c 'apt-get update && apt-get install -y git curl ca-certificates gcc gcc-c++ make binutils python3 xz unzip fuse libfuse openssl'

Node.js 24, если он ещё не установлен:

export NVM_DIR="${NVM_DIR:-$HOME/.nvm}"
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash
. "$NVM_DIR/nvm.sh"
nvm install 24

Исходники и начальные npm-зависимости:

git clone https://github.com/EvilDevRu/grigdesk.git &&
cd grigdesk &&
npm --prefix server ci &&
npm --prefix desktop ci

Затем выполните bin/grigdesk-ctl build из этой папки. Начальные зависимости сервера и окна нужны до запуска сборщика; веб-зависимости он готовит сам. Подробности — в руководстве по сборке.

После запуска

Откройте настройки, выберите исполнителя и выполните вход в свой аккаунт или укажите API-ключ. Затем создайте первый разговор. Для работы с кодом подключите проект.

Телефон и другой компьютер подключаются к работающему серверу — см. варианты подключения.

Если запуск остановился

Нет прав на запуск или ошибка FUSE

Откройте терминал в папке комплекта. При ошибке прав:

chmod +x ./GrigDesk
./GrigDesk

Если сообщение называет libfuse.so.2, установите пакеты из блока своего дистрибутива выше. На Ubuntu 24.04+ и Debian 13 библиотека называется libfuse2t64, на Ubuntu 22.04 и Debian 12 — libfuse2.

Сервер ожидает VPN

По умолчанию запуск местного сервера проверяет VPN-маршрут. Включите VPN. Если вашему окружению эта проверка не нужна, добавьте в ~/.grigdesk/.env строку ниже и перезапустите местный сервер. Остальные настройки файла сохраните.

GRIGDESK_REQUIRE_VPN=0

Уже использовал GrigDesk или сервер не подключается

Закройте прежнее окно перед запуском другой копии. Проверьте выбранную машину: сохранённое удалённое подключение не заменяется местным автоматически. Причина подключения видна в окне; местный журнал по умолчанию — ~/.grigdesk/state/grigdesk-server.log. Второй сервер на той же папке данных запускать не нужно.