インストール

ドキュメント作成中

一部の内容はまだ不完全な場合があります。

ThinkTerm は macOS、Linux、Windows 向けに リリースページ で公開されています。macOS と Linux ではインストールスクリプトでインストールします。あとで ThinkTerm が自分自身を更新できるのも、この方法で入れたときだけです。iOS と Android のアプリは開発中で、まだリリースされていません。

システム要件

システム	必要なもの
macOS	macOS 14 以降、Apple シリコンまたは Intel
Linux	x86_64 または arm64、glibc 2.35 以降 — Ubuntu 22.04、Debian 12、RHEL 10 以降
Windows	Windows 10 バージョン 1809 以降、x64

Linux のビルドは glibc にリンクしているため、Alpine のような musl のシステムではまったく動きません。glibc が古い場合はもっと分かりにくい形で失敗します — 読み込み時に、本当の原因ではなくシンボルのバージョンについてのメッセージが出ます — そのためインストールスクリプトは先にバージョンを確かめ、それを言葉で伝えます。どちらの場合も、ソースからビルドするのが答えです。

インストールスクリプト

curl -fsSL https://raw.githubusercontent.com/RoversX/thinkterm/main/install.sh | sh

スクリプトはこのマシン向けのリリースを選んでダウンロードし、ファイルのアップロード時に GitHub が記録した SHA-256 ダイジェストと照合します。一致しないダウンロードは拒否され、何もインストールされません。GitHub にそのファイルのダイジェストがない場合や、マシンに sha256sum も shasum もない場合は、黙っているのではなく、ダウンロードを検証していないことを伝えます。

インストールは現在のユーザーに対して行われ、root もパッケージマネージャーも要りません。

• Linux — プログラムは ~/.local/bin に入り、デスクトップ版は ~/.local/share の下にランチャー項目とアイコンを追加します。
• macOS — 署名済みの ThinkTerm.app を /Applications に、あなたが /Applications に書き込めない場合は ~/Applications に置き、コマンドラインツールを ~/.local/bin にリンクします。リンクはアプリの中を指していてファイルをコピーしないので、アプリの署名の範囲に入ったままです。

bash、zsh、fish の補完も ~/.local/share の下に入ります。その隣にはインストール内容の記録が残り、thinkterm update や 設定 › ソフトウェアアップデート があとでこれらのファイルを置き換えてよいと判断するのは、この記録によってです。

シェルの起動ファイルには手を付けません。~/.local/bin が PATH に入っていなければ、追加すべき行を表示します — Debian と Ubuntu では、次にログインするまで PATH に入らず、しかもそのときにディレクトリが存在している場合に限られます。あわせて、シェル統合を有効にする行（任意）も表示します。シェル統合はプロンプトの印を付け、ThinkTerm がシェルの作業ディレクトリを追えるようにします。

どちらの版も thinkterm の隣に wezterm コマンドを置きます。TERM_PROGRAM が WezTerm を示しているときにこのコマンドを探すツールのためです。WezTerm 本体も入っている場合、どちらの wezterm が動くかは PATH でどのディレクトリが先にあるかで決まります。

デスクトップ版かサーバー版か

版	中身
--desktop	アプリ、コマンドラインツール、TUI、セッションサーバー
--server	アプリ以外のすべて。Linux ではグラフィックライブラリも要りません

スクリプトはマシンから推測しません。画面のないマシンでも TUI は欲しいかもしれませんし、デスクトップが誰かの SSH の接続先かもしれないからです。端末でどちらのフラグも付けずに実行すると尋ねます。端末がまったくない環境（プロビジョニングのスクリプトなど）では、フラグが必須です。

2 つは排他的です。片方を入れるともう片方のファイルは削除されるので、サーバー版からデスクトップ版への移行は同じコマンドに --desktop を付けるだけで、アプリが加わり、ほかはそのまま残ります。逆向きならアプリとそのランチャーが削除されます。

オプション

オプション	効果
--desktop、--server	版を選ぶ
--version X	最新版ではなくリリース X をインストールする
--prefix DIR	~/.local ではなく DIR の下にインストールする。プログラムは DIR/bin に入る
--app-dir DIR	macOS のみ：ThinkTerm.app を DIR に置く
--from FILE	ダウンロード済みのアーカイブをインストールする。何も取得しない
--dry-run	何をするかを示し、ディスクに触れる前に止まる

オプションは sh -s -- を通してスクリプトに渡します。

curl -fsSL https://raw.githubusercontent.com/RoversX/thinkterm/main/install.sh | sh -s -- --server

GITHUB_TOKEN が設定されていれば、スクリプトのリクエストに付けて送られ、GitHub の匿名レート制限が外れます。ThinkTerm 自身のバックグラウンドの更新確認がこれを読むことはありません。アップデート を参照してください。

アップグレードとアンインストール

スクリプトをもう一度実行することがアップグレードです。バージョンは比較しません — 取得したリリースを、そこにあるものの上にインストールします — そのため --version を付ければ古いリリースに戻すこともできます。thinkterm update や設定の アップデートをインストール が代わりに実行するのも、このスクリプトです。詳しくは アップデート を参照してください。

ファイルはその場で入れ替わるので、すでに動いているものは起動時のバージョンのままです。インストール前から動いているセッションサーバーがあれば、スクリプトはそれを伝えます。再起動するまで、新しいアプリやコマンドラインツールはそのサーバーとの通信を拒むことがあります。macOS では ThinkTerm が開いているときもそう伝えます。新しいバージョンは次に開いたときに起動するからです。

アンインストーラーはありません。スクリプトは終了時にインストールしたファイルをすべて一覧にします。ThinkTerm を削除するとは、それらを削除することです。

Linux で足りないライブラリ

アプリに必要なライブラリは、パッケージマネージャーなら一緒に入れてくれますが、tarball にはできません。デスクトップ版では、アプリに足りないライブラリをシステムに問い合わせ、それぞれを提供するパッケージ名を apt、dnf、zypper について示します。止めずに警告するだけです。コマンドラインツールとセッションサーバーはそれらがなくても動き、ライブラリを入れればアプリも起動します。

リリースの中身

macOS

アーキテクチャごとに 1 つの zip、arm64 と x86_64 があり、署名と公証を済ませた ThinkTerm.app が入っています。インストールスクリプトはどちらの版でもこの zip を使います。

自分で展開してアプリを「アプリケーション」に移すこともできます。手で置いたコピーも ThinkTerm は更新できます。アップデートをインストール はそれをその場所で置き換え、コマンドラインツールを ~/.local/bin に追加し、以後はスクリプトでインストールしたものと同じように扱います。

Linux

ダウンロード	中身
thinkterm-<version>-linux-<arch>.tar.gz	デスクトップ版。インストールスクリプトが入れるもの
thinkterm-server-<version>-linux-<arch>.tar.gz	サーバー版
.deb	thinkterm と thinkterm-server のパッケージ。Ubuntu 22.04 でビルド
.rpm	thinkterm と thinkterm-server のパッケージ。Fedora でビルド
.AppImage	1 ファイルのデスクトップアプリ。Ubuntu 22.04 でビルド

いずれも x86_64 と arm64 があります。

.deb と .rpm のパッケージは、どちらも wezterm コマンドを提供するため、WezTerm のパッケージと同時にはインストールできません。デスクトップ版とサーバー版のパッケージも互いに排他です。パッケージはパッケージマネージャーで、AppImage は AppImageUpdate で更新します。ThinkTerm はそれらのファイルを置き換えず、そちらを案内します。

Windows

Windows にインストールスクリプトはありません。リリースには x64 向けのダウンロードが 2 つあります。

インストーラー ThinkTerm-<version>-setup.exe は管理者権限を求め、Program Files にインストールします。ThinkTerm のフォルダーをシステムの PATH に追加し、エクスプローラーのフォルダー、フォルダーの背景、ドライブのメニューに Open ThinkTerm here を加え、デスクトップのショートカットも作成できます。ThinkTerm の中から更新すると、次のインストーラーをダウンロードして実行します。

zip ThinkTerm-windows-<version>.zip は好きな場所に展開してそこから動かせ、PATH にもエクスプローラーにも何も加えません。実行ファイルの隣にある thinkterm.lua はユーザープロファイルにある設定より優先されるので、コピーごとに設定を持ち歩けます。設定 を参照してください。ただし一緒に移るのは設定だけで、Space、ホスト、その他の ThinkTerm のデータは引き続きユーザープロファイルに保存されます。更新するときは、新しい zip を同じ場所に展開します。

サーバーへのインストール

SSH で接続するマシンに ThinkTerm が必要なのは、ホストでセッションを動かし続ける常駐接続、ThinkTerm Connect を使う場合だけです。サーバー版で足ります。

curl -fsSL https://raw.githubusercontent.com/RoversX/thinkterm/main/install.sh | sh -s -- --server

macOS のサーバー版は、アプリのバンドルを ~/.local/libexec に置き、「アプリケーション」や Launchpad には出しません。欲しいのは中のプログラムであって、Dock のアイコンではないからです。Linux では、apt や dnf で管理したいマシンなら thinkterm-server パッケージが同じ役割を果たします。

セッションサーバーには root もサービスファイルも要りません。起動のしかた、ログアウト後も動かし続ける方法、接続方法ごとにホストに必要なものは リモート で説明しています。

初めて開いたとき

アプリを初めて開くと、ThinkTerm へようこそ というページが 1 枚表示され、言語 と 外観（システムに合わせる、ライト、ダーク）の 2 つを選びます。どちらも選んだ時点で反映されるので、結果を見てから決められます。使ってみる で選択を保ち、スキップ でこのページが開いたときの状態に戻します。どちらでも、このページは二度と表示されません。

どちらもあとで 設定 › 一般 › 言語 と 設定 › 外観 で変更できます。

新規インストールでは、最初からローカル端末をバックグラウンドのセッションサーバーに置くので、ThinkTerm を終了しても端末は終わりません。この設定と、オフにする方法は リモート で説明しています。

関連

• アップデート — インストールしたコピーを最新に保つ方法
• リモート — SSH、Mosh、ThinkTerm Connect のためのホストの準備
• 設定 — 各システムで設定とデータが置かれる場所
• プライバシーとセキュリティ — ThinkTerm が送るもの、保存するもの