本文へスキップ
Chapters
  1. Omarchy へようこそ!
  2. はじめに
  3. MacやWindowsから乗り換えたら
  4. ナビゲーション
  5. トップバー
  6. テーマ
  7. ホットキー
  8. 統一クリップボードと履歴
  9. リマインダー
  10. 通知
  11. テキスト抽出とディクテーション
  12. スクリーンショットと録画
  13. トグル、アイドルとスクリーンセーバー
  14. Omarchy CLI
  15. ターミナル
  16. Neovim
  17. AI
  18. 開発ツール
  19. シェルツール
  20. シェル関数
  21. TUIs
  22. GUI
  23. ブラウザ
  24. 商用アプリ/サービス
  25. Web アプリ
  26. ゲーミング
  27. PDF への記入
  28. Windows VM
  29. その他のパッケージ
  30. アップデート
  31. Dotfiles
  32. シェルプラグイン
  33. モニター
  34. キーボード、マウス、トラックパッド
  35. ネットワーキング
  36. システムスリープ
  37. ハードウェア認証
  38. フォント
  39. 背景
  40. プロンプト
  41. ブランディング
  42. よくある調整
  43. 独自のテーマを作る
  44. Mac サポート
  45. トラブルシューティング
  46. FAQ
  47. システムスナップショット
  48. セキュリティ
  49. Omarchy on...
  50. デュアルブートインストール
  51. 無人インストール

マニュアル

無人インストール

Omarchy ISO は、キーボードの前に誰もいなくても自動でインストールできる。インストーラーが cidata というラベルの付いた2台目のドライブに設定ファイルを見つけると、それらをコピーし、セットアップウィザードを完全にスキップし、自動で完成したシステムへ再起動する。特別な ISO ビルドも、余分なブートメニュー項目もいらない。そのようなドライブが接続されていなければ何も変わらず、通常のウィザードが表示される。

これにより Omarchy は使い捨ての開発環境のベースイメージとして優れている。Proxmox や Packer で VM を作成し、起動し、席を外して、SSH で入ればいい。cidata は cloud-init の NoCloud ラベルなので、一般的な仮想化ツールはすべて、そのようなドライブの接続方法をすでに知っている。

設定ファイル

これらのファイルはインストーラー自身のウィザードが書き出すものとまったく同じなので、最初のセットを手に入れる一番簡単な方法は、対話式インストールを1回実行し(たとえば VM で)、/root に書き出されたものをコピーすることだ。

ファイル 必須 目的
user_configuration.json Yes ディスク、ホスト名、タイムゾーン、キーボード
user_credentials.json Yes ユーザー名とパスワードハッシュ
user_encrypt_installation.txt No 設定に disk_encryption ブロックが含まれている場合に true
authorized_keys No SSH 公開鍵、1行に1つ
tailscale_authkey No 初回起動時に tailnet へ参加するための Tailscale 認証キー

user_credentials.json 用のパスワードハッシュは openssl passwd -6 "yourpassword" で生成する。

git コミット用の名前とメールアドレスはインストールの一部ではない。マシンが起動したら、たとえば SSH 経由で omarchy setup git --name "Jane Doe" --email jane@example.com で設定する。

user_credentials.json の代わりに、defer-provisioning という名前の空ファイルを入れることもできる。これにより、対話式にも起動できる別の所有者向けの準備インストールと同じものが実行される。マシンは個人情報を一切持たずにインストールされ、最初に起動した人が自分のキーボードを選び、自分のユーザーを作成する。ドライブに誰の認証情報も入れるべきではないイメージング用リグ向けのモードだ。

SSH アクセス

authorized_keys が存在する場合、インストールではその鍵をユーザーの ~/.ssh/authorized_keys として設定し、sshd を有効にして、そのためのファイアウォールを開く。(標準の Omarchy インストールでは openssh が同梱されているがサービスは無効でポートも閉じているため、無人マシンはそうしなければ到達不能になってしまう。)インストールでは自分の鍵を追加するだけであり、SSH デーモンの他の認証設定は一切緩めない。

tailscale_authkey が存在する場合、その代わりにマシンは初回起動時に tailnet へ参加する。Tailscale は ISO に同梱されたパッケージからインストールされ、ファイアウォールでは tailnet インターフェースが許可され、バックグラウンドジョブがマシンに実際にネットワークがつながり次第参加を実行し、成功するまで再試行する。再利用可能で事前承認済みのキーを使えば、1つのドライブイメージで多くのマシンに対応できる。

cidata ドライブの構築

正しいラベルが付いたファイルシステムなら何でも使える。小さな ISO が簡単な方法だ。

mkdir cidata
cp user_configuration.json user_credentials.json authorized_keys cidata/
genisoimage -output cidata.iso -volid cidata -joliet -rock cidata/

次に、それを Omarchy ISO と一緒に VM に接続する。以下は Proxmox の完全な例だ。

qm create 101 --name my-omarchy \
  --bios ovmf --machine q35 --cpu host --cores 4 --memory 8192 \
  --ostype l26 --scsihw virtio-scsi-single \
  --efidisk0 local-lvm:0,efitype=4m,pre-enrolled-keys=0 \
  --scsi0 local-lvm:40,discard=on,iothread=1 \
  --net0 virtio,bridge=vmbr0 --vga virtio --serial0 socket \
  --ide2 local:iso/omarchy.iso,media=cdrom \
  --ide3 local:iso/cidata.iso,media=cdrom \
  --boot order='scsi0;ide2'

qm start 101

ブート順序でディスクを最初に挙げているのは意図的だ。空のディスクは初回起動時に ISO へフォールスルーし、インストールされたシステムはそれ以降ずっとディスクから起動する。

2つの注意点

暗号化した無人インストールは完全には無人にならない。初回起動時に LUKS パスフレーズを入力する人が依然として必要だ。そして user_configuration.json の disk_encryption ブロックにはそのパスフレーズが平文で含まれているので、暗号化したインストールから構築した cidata ドライブは、それ自体が秘密情報であるとして扱え。