Сервер Linux
Установите octoboardd, серверную программу Octoboard (в приложении она называется «служба»), на сервере Linux без прав root. Подключайтесь к ней из приложения для macOS или Windows либо из браузера, в обоих случаях по SSH.
Для x86_64 и aarch64, в любом дистрибутиве.
Перед началом
Заголовок раздела «Перед началом»- Сервер Linux, на который можно войти по SSH. SSH — это защищённый способ войти на другую машину и вводить на ней команды. Адрес сервера и имя пользователя вам сообщает его провайдер.
- Приложение Octoboard на вашем компьютере для macOS или Windows, если вы хотите работать в настольном приложении (рекомендуется).
Чтобы войти, откройте Терминал (macOS) или PowerShell (Windows) на своём компьютере и выполните команду ниже, подставив своё имя пользователя вместо <you> и адрес сервера вместо <server>. При первом входе на вопрос, доверять ли серверу, ответьте yes.
ssh <you>@<server>Шаги 1 и 2 ниже выполняются на сервере, в этом же окне после входа.
Установка
Заголовок раздела «Установка»-
Установите octoboardd на сервере.
Terminal window curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | shБудет выведена строка, начинающаяся с
Installed octoboardd. -
Запустите его на сервере.
Terminal window octoboardd startБудет выведена строка, начинающаяся с
Octoboard started. -
Подключитесь к нему со своего компьютера одним из двух способов:
-
Из настольного приложения (рекомендуется): выполните шаги из раздела Подключение к серверу Linux в инструкции по SSH.
-
Из браузера: выполните на сервере эту команду.
Terminal window octoboardd addressОна выводит две вещи: адрес для браузера, начинающийся с
http://127.0.0.1:, и командуssh. На своём компьютере скопируйте командуssh, замените<server>адресом сервера (IP-адресом или именем, по которому вы входите на него) и выполните её в Терминале или PowerShell. Она может запросить пароль, после чего больше ничего не покажет: это нормально. Оставьте это окно открытым: если его закрыть, соединение прервётся. Затем откройте выведенный адрес в браузере.
-
Всё получилось, если Octoboard открылся в новом окне настольного приложения или во вкладке браузера.
Если octoboardd не найден
Заголовок раздела «Если octoboardd не найден»Если при установке сказано, что папки, путь к которой оканчивается на .local/bin (например, /home/<you>/.local/bin), нет в вашем PATH, оболочка не может найти octoboardd по имени. Запустите программу по полному пути, который вывела установка, или добавьте ~/.local/bin в PATH (например, в ~/.profile) и войдите снова.
Как оставить программу работающей после выхода и перезагрузки
Заголовок раздела «Как оставить программу работающей после выхода и перезагрузки»Если запустить octoboardd командой octoboardd start, он останавливается при перезапуске сервера, и сам больше не запускается: выполните octoboardd start ещё раз или подключитесь из настольного приложения, которое предложит запустить его за вас. На некоторых серверах он останавливается и при выходе из системы.
Чтобы он запускался вместе с сервером и продолжал работать после вашего выхода, установите его как службу:
curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | sh -s -- --serviceЭта команда устанавливает программу, настраивает её как пользовательскую службу systemd и запускает. Затем она включает lingering — режим, при котором ваши службы работают, пока вы не вошли в систему. Если команда сообщит, что не смогла этого сделать, выполните один раз следующее (может понадобиться sudo):
loginctl enable-linger "$USER"Порт по умолчанию — 3369. Чтобы использовать другой, добавьте --port <port> в конец команды установки службы или команды octoboardd start.
Обновление
Заголовок раздела «Обновление»Octoboard никогда не обновляется сам по себе: когда выходит новая версия, браузер сообщает об этом, и вы сами выбираете, когда её установить. После установки новой версии Octoboard сам перезапускается в неё, если это не прервёт ни один сеанс; если какие-то сеансы прервутся, он перечисляет их и сначала спрашивает.
-
В браузере: нажмите Загрузить и установить там, где сказано, что доступна новая версия.
-
На сервере: выполните эту команду.
Terminal window octoboardd updateЕсли она спросит, перезапустить ли сейчас, ответьте
y, чтобы перезапустить, или нажмите Enter, чтобы пока оставить работать старую версию. Чтобы перезапустить позже, выполнитеoctoboardd restart.
Если octoboardd update сообщает, что не может заменить программу, например потому, что она установлена в место, куда у вас нет прав записи, выполните вместо этого команду установки (или команду установки службы) ещё раз. Она перезапустится так же, когда это безопасно, а иначе подскажет выполнить octoboardd restart.