コンテンツにスキップ
Octoboard ドキュメント

Linux サーバー

Octoboard のサーバー用プログラム octoboardd(アプリでは「デーモン」と呼びます)を、root 権限なしで Linux サーバーにインストールします。macOS または Windows のアプリからも、ブラウザからも、SSH 経由で使えます。

x86_64 と aarch64 に対応し、ディストリビューションは問いません。

  • SSH でサインインできる Linux サーバー。 SSH とは、別のマシンに安全にサインインして、コマンドを入力するための仕組みです。サーバーのアドレスとユーザー名は、サーバーの提供元から案内されます。
  • 自分のコンピューターに入れた Octoboard アプリ。macOS 用または Windows 用です。デスクトップアプリで作業する場合に必要です(おすすめです)。

サインインするには、自分のコンピューターでターミナル(macOS)または PowerShell(Windows)を開き、次のコマンドを実行します。<you> の部分は自分のユーザー名に、<server> の部分はサーバーのアドレスに置き換えてください。初回は、サーバーを信頼するか尋ねられるので、yes と答えます。

Terminal window
ssh <you>@<server>

以下の手順 1 と 2 は、サインインしたそのウィンドウで、サーバー上で実行します。

  1. サーバーに octoboardd をインストールします。

    Terminal window
    curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | sh

    Installed octoboardd で始まる行が表示されます。

  2. サーバーで octoboardd を起動します。

    Terminal window
    octoboardd start

    Octoboard started で始まる行が表示されます。

  3. 自分のコンピューターから、次のどちらかの方法でつなぎます。

    • デスクトップアプリから(おすすめ): SSH ガイドの Linux サーバーに接続するに従います。

    • ブラウザから: サーバーで次のコマンドを実行します。

      Terminal window
      octoboardd address

      2 つのものが表示されます。http://127.0.0.1: で始まるブラウザのアドレスと、ssh コマンドです。自分のコンピューターで ssh コマンドをコピーし、<server> をサーバーのアドレス(サインインに使う IP アドレスまたは名前)に置き換えて、ターミナルまたは PowerShell で実行します。パスワードを聞かれることがあり、その後は何も表示されませんが、正常です。そのウィンドウは開いたままにしてください。閉じると接続が切れます。そのうえで、表示されたアドレスをブラウザで開きます。

デスクトップアプリの新しいウィンドウ、またはブラウザのタブで Octoboard が開けば成功です。

インストール時に、.local/bin で終わるフォルダー(たとえば /home/<you>/.local/bin)が PATH に入っていないと表示された場合、シェルは octoboardd を名前だけでは見つけられません。インストール時に表示されたフルパスで実行するか、~/.local/bin を PATH に追加(たとえば ~/.profile に記述)してから、もう一度サインインしてください。

ログアウトや再起動のあとも動かし続ける

Section titled “ログアウトや再起動のあとも動かし続ける”

octoboardd start で起動した octoboardd は、サーバーが再起動すると止まり、自動では再開しません。もう一度 octoboardd start を実行するか、デスクトップアプリからつなぎます(アプリが起動を提案してくれます)。サーバーによっては、サインアウトしたときにも止まります。

サーバーの起動と同時に始まり、サインアウトしても動き続けるようにするには、代わりにサービスとしてインストールします。

Terminal window
curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | sh -s -- --service

このコマンドは、プログラムをインストールし、systemd のユーザーサービスとして設定して起動します。続けて lingering をオンにします。これは、サインインしていない間もサービスを動かし続けるための設定です。できなかったと表示された場合は、次のコマンドを一度だけ実行してください(sudo が必要なことがあります)。

Terminal window
loginctl enable-linger "$USER"

既定のポートは 3369 です。別のポートを使うには、サービスのコマンドの末尾か octoboardd start に --port <port> を付けます。

Octoboard が自分で勝手にアップグレードすることはありません。新しいバージョンが出るとブラウザでお知らせするので、インストールするタイミングは自分で選べます。新しいバージョンのインストールが終わると、中断されるセッションがなければ、Octoboard は自動で再起動して新しいバージョンに切り替わります。中断されるセッションがある場合は、それを一覧で示して、先に確認します。

  • ブラウザで: 新しいバージョンがあると表示されている場所で、ダウンロードしてインストールを選びます。

  • サーバーで: 次のコマンドを実行します。

    Terminal window
    octoboardd update

    今すぐ再起動するか尋ねられたら、再起動するなら y と答えます。Enter キーを押すと、当面は古いバージョンのまま動かし続けます。あとで再起動するには、octoboardd restart を実行します。

octoboardd update が「プログラムを置き換えられない」と表示した場合(たとえば、書き込めない場所にインストールされているときなど)は、代わりにインストールのコマンド(またはサービスのコマンド)をもう一度実行してください。安全なときは同じように再起動し、そうでなければ octoboardd restart を実行するよう案内されます。

アーカイブを直接ダウンロードする

Section titled “アーカイブを直接ダウンロードする”
x86_64 アーカイブ aarch64 アーカイブ 過去のバージョンをすべて見る