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

Запустити агента в Linux можна двома способами: як системну службу, що стартує разом із машиною, або як звичайний процес, який ви запускаєте самі. Один і той самий архів годиться для обох.

Оберіть архів

Архів	Для чого
`filemote-<версія>-linux-x64.tar.gz`	Звичайні ПК і сервери
`filemote-<версія>-linux-arm64.tar.gz`	Raspberry Pi 4/5, AWS Graviton, Oracle Ampere

Обидва розпаковуються в одну теку, де лежать FilemoteAgent, FilemoteCli, install.sh, apply-update.sh, порожній app_settings.json і каталог AiService.

Архіви збираються на Windows, де немає unix-біта виконання, тому chmod +x — завжди перший крок. Самі бінарники самодостатні, тож агентові не потрібне встановлення .NET — скрипт встановлення ставить .NET усе одно, бо розгортає повне середовище, разом з AI.

Встановлення як служби (потрібен root)

tar xzf filemote-<версія>-linux-x64.tar.gz
cd filemote-<версія>-linux-x64
chmod +x install.sh
sudo ./install.sh

Скрипт:

визначає ваш пакетний менеджер (apt, dnf, yum, zypper або pacman) і, якщо не впізнає жодного, попереджає, а не перериває роботу;
встановлює середовище виконання .NET 8, додаючи пакетний репозиторій Microsoft на Debian та Ubuntu і відкочуючись на dotnet-install.sh від Microsoft, якщо через пакунки не вийшло;
встановлює актуальний Python, якщо немає нічого новішого за 3.10 — явно 3.12 на apt, dnf і zypper та те, що дистрибутив вважає актуальним, на yum і pacman, — а якщо й це не вдалося, вимикає AI-сервіс і продовжує, замість того щоб кинути все встановлення;
копіює агента в /opt/filemote разом з AI-сервісом і помічником оновлення;
створює systemd-юніт filemote-agent.

Юніт працює від вашого користувача, а не від root, перезапускається після збою через п'ять секунд, обмежений 8 ГБ пам'яті та 80% CPU і пише журнал у journald.

Юніт увімкнено, але не запущено. Увімкнено — означає, що він підніметься після перезавантаження; свіже встановлення лишається у стані inactive (dead), доки ви його не запустите, а зробити це слід після налаштування на наступному кроці.

Налаштовуйте ту копію, яку справді читає служба

Саме тут найчастіше помиляються під час першого встановлення. FilemoteCli не копіюється в /opt/filemote і типово пише app_settings.json поруч зі своїм бінарником. Запустіть його просто з розпакованого архіву — і налаштуєте файл, який служба ніколи не читає, причому ніде не буде помилки: з погляду служби вона просто ще не має облікових даних.

Вкажіть йому файл самої служби:

sudo ./FilemoteCli --config /opt/filemote/app_settings.json

Оберіть [2] Pair with a code, вставте код із сайту, потім [7] Save and exit — повний покроковий опис є у статті як пов'язати пристрій з обліковим записом. Після цього запустіть службу:

sudo systemctl start filemote-agent
sudo systemctl status filemote-agent

Встановлення без root

На спільному хостингу або в контейнері скрипт можна взагалі не використовувати:

tar xzf filemote-<версія>-linux-x64.tar.gz
cd filemote-<версія>-linux-x64
chmod +x FilemoteCli FilemoteAgent
./FilemoteCli      # налаштувати та пов'язати
./FilemoteAgent    # запустити

Після перезавантаження нічого не стартує, і залежності AI не встановлюються, але доступ до файлів працює так само. Запускайте агента під tmux, screen або користувацьким systemd-юнітом, якщо хочете, щоб він пережив вашу сесію.

Прапорці скрипта

Прапорець	Що робить
`--no-ai`	Повністю пропустити AI-сервіс — ні Python, ні залежностей
`--no-autostart`	Встановити файли, але не створювати systemd-юніт
`--prefix /path`	Встановити не в `/opt/filemote`, а в інше місце
`--model <id>`	Заздалегідь обрати основну AI-модель
`--device cpu\|gpu\|auto`	Обчислювальний пристрій для AI
`--gpu`	Зібрати AI-рушій із підтримкою GPU
`--hf-token <token>`	Токен Hugging Face, для моделей з обмеженим доступом

Прапорці моделі, пристрою та токена вливаються в app_settings.json, не чіпаючи наявних налаштувань, тому повторний запуск скрипта не скасовує вашу конфігурацію. Нерозпізнаний прапорець спричиняє попередження і ігнорується.

AI в Linux

Без --gpu AI-рушій встановлюється готовим CPU-пакунком. З --gpu він збирається з джерел — із CUDA, якщо є nvidia-smi, інакше з Vulkan, — а отже, спершу буде встановлено компілятор і CMake, і крок займе кілька хвилин.

На Raspberry Pi з обсягом пам'яті менше 8 ГБ встановлюйте з --no-ai.

Журнали та команди служби

sudo systemctl start filemote-agent      # запустити зараз
sudo systemctl status filemote-agent     # чи працює
sudo journalctl -u filemote-agent -f     # стежити за журналом

Якщо пристрій так і не з'являється в мережі, пройдіть за статтею пристрій показано як офлайн.

Оновлення зі встановлення до ребрендингу

Якщо на машині ще лишилася стара служба rfm-agent, скрипт зупинить її, вимкне та видалить її юніт — два агенти, що конкурують за один обліковий запис, не потрібні нікому — і перенесе ваші налаштування та завантажені AI-моделі з /opt/rfm у новий префікс. Стара тека лишається, щоб ви видалили її самі, коли переконаєтесь, що все гаразд.

Оновлено 2026-07-31

Не допомогло — написати в підтримку