【2025年版】Omarchyトラブルシューティング集 - よくある問題と解決法
Omarchyで発生しやすい問題と解決方法を初心者にもわかりやすく解説。インストール、起動、ディスプレイ、日本語入力、アップデートなどのトラブルを網羅します。
Omarchyトラブルシューティング集 - よくある問題と解決法
Omarchyを使っていると、様々な問題に遭遇することがあります。
この記事では、よくある問題とその解決方法を初心者にもわかりやすく解説します。
目次
インストール時の問題
USBから起動できない
症状: USBを挿してもOmarchyのインストーラーが起動しない
原因と解決方法:
1. Secure Bootが有効になっている
OmarchyはSecure Bootに対応していません。
2. TPMが有効になっている
TPMも無効化が必要な場合があります。
3. ブート順序が間違っている
4. USBの作成に失敗している
インストール中にエラーが発生する
症状: インストール途中でエラーメッセージが表示される
ディスクが認識されない
ディスク容量が足りない
起動時の問題
黒い画面のまま起動しない
症状: ログイン画面が表示されず、黒い画面のまま
GPUドライバの問題
特にNVIDIA GPUで起こりやすい問題です。
NVIDIAドライバのインストール:
Hyprlandが起動しない
ログイン後すぐにクラッシュする
症状: パスワード入力後、すぐにログイン画面に戻る
ディスプレイ・グラフィックの問題
画面がカクカクする・ティアリングが発生する
症状: スクロール時などに画面がちらつく
NVIDIA GPUの場合
AMD GPUの場合
画面の解像度・スケーリングがおかしい
症状: 文字が小さすぎる、または大きすぎる
アプリケーション側のスケーリング:
外部モニターが認識されない
日本語入力の問題
日本語が入力できない
症状: 日本語入力に切り替えられない
fcitx5のインストールと設定
設定後の確認
日本語フォントが表示されない（豆腐になる）
キーボードレイアウトを日本語に変更したい
ネットワークの問題
Wi-Fiに接続できない
NetworkManagerを使用
ドライバの問題
有線LANが認識されない
アップデートの問題
アップデート中にエラーが発生する
症状: pacmanでエラーが出る
パッケージの競合
キーリングの問題
ディスク容量不足
アップデート後に起動しなくなった
症状: アップデート後、システムが起動しない
スナップショットから復元
Omarchyは自動的にスナップショットを作成しています。
手動で復元:
アプリケーションの問題
アプリケーションが起動しない
依存関係の問題
Waylandとの互換性問題
一部のアプリケーションはWaylandで動作しません。
Electronアプリが正常に動作しない
VSCode、Slack、Discordなど：
永続的に設定:
Flatpakアプリケーションの問題
設定の問題
設定を初期状態に戻したい
キーバインドが効かない
テーマが反映されない
ログの確認方法
問題が解決しない場合、ログを確認すると原因がわかることがあります。
システムログ
Hyprlandのログ
Xorgのログ（XWayland）
ヘルプを求める方法
自分で解決できない場合は、コミュニティに助けを求めましょう。
情報を整理する
質問する前に、以下の情報を整理しておきましょう：
サポートを求める場所
| 場所 | URL | 用途 |
|---|---|---|
| GitHub Discussions | github.com/basecamp/omarchy/discussions | 質問・相談 |
| GitHub Issues | github.com/basecamp/omarchy/issues | バグ報告 |
| Discord | （公式サイトから参加） | リアルタイムの相談 |
質問のテンプレート
[エラーログを貼り付け]
まとめ
トラブルシューティングの基本的な流れ:
- 問題を特定する - 何が起きているか明確にする
- ログを確認する - エラーメッセージを探す
- 原因を調べる - この記事やArch Wikiを参照
- 解決策を試す - 一つずつ試して結果を確認
- 助けを求める - 自分で解決できなければコミュニティへ
Omarchyはまだ新しいプロジェクトなので、問題に遭遇することもあります。
しかし、Arch Linuxベースなので、Arch Wikiの情報が多くの場合で役立ちます。