Linux サーバー
Octoboard のサーバー用プログラム octoboardd(アプリでは「デーモン」と呼びます)を、root 権限なしで Linux サーバーにインストールします。macOS または Windows のアプリからも、ブラウザからも、SSH 経由で使えます。
x86_64 と aarch64 に対応し、ディストリビューションは問いません。
- SSH でサインインできる Linux サーバー。 SSH とは、別のマシンに安全にサインインして、コマンドを入力するための仕組みです。サーバーのアドレスとユーザー名は、サーバーの提供元から案内されます。
- 自分のコンピューターに入れた Octoboard アプリ。macOS 用または Windows 用です。デスクトップアプリで作業する場合に必要です(おすすめです)。
サインインするには、自分のコンピューターでターミナル(macOS)または PowerShell(Windows)を開き、次のコマンドを実行します。<you> の部分は自分のユーザー名に、<server> の部分はサーバーのアドレスに置き換えてください。初回は、サーバーを信頼するか尋ねられるので、yes と答えます。
ssh <you>@<server>以下の手順 1 と 2 は、サインインしたそのウィンドウで、サーバー上で実行します。
インストール
Section titled “インストール”-
サーバーに octoboardd をインストールします。
Terminal window curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | shInstalled octoboarddで始まる行が表示されます。 -
サーバーで octoboardd を起動します。
Terminal window octoboardd startOctoboard startedで始まる行が表示されます。 -
自分のコンピューターから、次のどちらかの方法でつなぎます。
-
デスクトップアプリから(おすすめ): SSH ガイドの Linux サーバーに接続するに従います。
-
ブラウザから: サーバーで次のコマンドを実行します。
Terminal window octoboardd address2 つのものが表示されます。
http://127.0.0.1:で始まるブラウザのアドレスと、sshコマンドです。自分のコンピューターでsshコマンドをコピーし、<server>をサーバーのアドレス(サインインに使う IP アドレスまたは名前)に置き換えて、ターミナルまたは PowerShell で実行します。パスワードを聞かれることがあり、その後は何も表示されませんが、正常です。そのウィンドウは開いたままにしてください。閉じると接続が切れます。そのうえで、表示されたアドレスをブラウザで開きます。
-
デスクトップアプリの新しいウィンドウ、またはブラウザのタブで Octoboard が開けば成功です。
octoboardd が見つからないとき
Section titled “octoboardd が見つからないとき”インストール時に、.local/bin で終わるフォルダー(たとえば /home/<you>/.local/bin)が PATH に入っていないと表示された場合、シェルは octoboardd を名前だけでは見つけられません。インストール時に表示されたフルパスで実行するか、~/.local/bin を PATH に追加(たとえば ~/.profile に記述)してから、もう一度サインインしてください。
ログアウトや再起動のあとも動かし続ける
Section titled “ログアウトや再起動のあとも動かし続ける”octoboardd start で起動した octoboardd は、サーバーが再起動すると止まり、自動では再開しません。もう一度 octoboardd start を実行するか、デスクトップアプリからつなぎます(アプリが起動を提案してくれます)。サーバーによっては、サインアウトしたときにも止まります。
サーバーの起動と同時に始まり、サインアウトしても動き続けるようにするには、代わりにサービスとしてインストールします。
curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | sh -s -- --serviceこのコマンドは、プログラムをインストールし、systemd のユーザーサービスとして設定して起動します。続けて lingering をオンにします。これは、サインインしていない間もサービスを動かし続けるための設定です。できなかったと表示された場合は、次のコマンドを一度だけ実行してください(sudo が必要なことがあります)。
loginctl enable-linger "$USER"既定のポートは 3369 です。別のポートを使うには、サービスのコマンドの末尾か octoboardd start に --port <port> を付けます。
アップグレード
Section titled “アップグレード”Octoboard が自分で勝手にアップグレードすることはありません。新しいバージョンが出るとブラウザでお知らせするので、インストールするタイミングは自分で選べます。新しいバージョンのインストールが終わると、中断されるセッションがなければ、Octoboard は自動で再起動して新しいバージョンに切り替わります。中断されるセッションがある場合は、それを一覧で示して、先に確認します。
-
ブラウザで: 新しいバージョンがあると表示されている場所で、ダウンロードしてインストールを選びます。
-
サーバーで: 次のコマンドを実行します。
Terminal window octoboardd update今すぐ再起動するか尋ねられたら、再起動するなら
yと答えます。Enter キーを押すと、当面は古いバージョンのまま動かし続けます。あとで再起動するには、octoboardd restartを実行します。
octoboardd update が「プログラムを置き換えられない」と表示した場合(たとえば、書き込めない場所にインストールされているときなど)は、代わりにインストールのコマンド(またはサービスのコマンド)をもう一度実行してください。安全なときは同じように再起動し、そうでなければ octoboardd restart を実行するよう案内されます。