Contents
Dockpit® の概要と公式システム要件
Dockpit® は Windows 11 向けに設計された軽量コンテナプラットフォームです。高速起動と低リソース消費を実現し、開発・テスト環境への導入ハードルを下げることが主な目的です。本セクションでは、インストール前に必ず確認すべき 公式システム要件 をまとめます。要件を満たしていれば、基本的な動作は保証されますので、トラブルの予防につながります。
公式が定める最低要件
| 項目 | 必須条件 | 推奨環境 |
|---|---|---|
| 対応 OS | Windows 11 Home / Pro / Enterprise Version 22H2 以降（Microsoft の公式サポートページ[^1]） | Windows 11 Version 24H2 またはそれ以降 |
| CPU | x86_64 (Intel®/AMD®) プロセッサ、ハードウェア仮想化 (VT‑x / AMD‑V) が有効 | 同上 + 4 コア以上 |
| メモリ | 最低 8 GB | 推奨 16 GB 以上 |
| ディスク容量 | インストーラ本体約 300 MB、コンテナイメージ保存用に最低 20 GB の空き領域 | 30 GB 以上の余裕を確保 |
| ネットワーク | 有線または Wi‑Fi 接続が可能な NIC が1つ以上 | 複数 NIC によるブリッジング推奨 |
要点：上記条件を満たすマシンであれば、Dockpit® のインストール・起動に支障はありません。
WSL 2 と Hyper‑V の有効化手順
WSL 2 と Hyper‑V は Dockpit® がコンテナを実行する基盤です。PowerShell でも GUI でも同等の機能が有効になりますので、環境や好みに合わせて選択してください。
PowerShell による有効化（管理者権限必須）
以下のコマンドは 管理者として実行 した PowerShell で順に入力します。各コマンドは Windows の機能をオンにするだけで、追加ライセンスは不要です[^2]。
- WSL 2 機能の有効化
powershell
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart - Virtual Machine Platform の有効化（WSL 2 に必須）
powershell
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart - Hyper‑V の全機能を有効化
powershell
dism.exe /online /enable-feature /featurename:Microsoft-Hyper-V-All /all /norestart - 再起動
変更を反映させるために PC を必ず再起動してください。
ポイント：PowerShell での有効化は数分で完了し、スクリプト化も容易です。
GUI（「Windows の機能」）での設定手順
GUI が好みの場合は、以下の流れで同等の設定が行えます。
- 「Windows の機能」ダイアログを開く
- スタートメニュー → 「Windows の機能」と入力し、表示された項目をクリック。
- 必要なチェックボックスにチェック
- 「Windows Subsystem for Linux」
- 「Virtual Machine Platform」
- 「Hyper‑V（Hyper‑V 管理ツール、Hyper‑V プラットフォーム）」
- 「OK」を押してインストール
- 再起動を促されたら実行
ポイント：GUI でもコマンドラインと同様に再起動が必要です。
公式サイトからインストーラ取得・チェックサム確認・管理者権限でのインストール
安全な導入は、公式ダウンロードページから最新版を取得し、SHA‑256 ハッシュ値で検証することから始まります。
ダウンロードとハッシュ値の検証手順
- 公式サイトへアクセス
- URL: https://dockpit.io/download（2026 年 7 月時点）
- 「Windows 11 用インストーラ」リンクをクリックし、
Dockpit-Setup.exeを取得。 - SHA‑256 ハッシュ値の確認
- ダウンロードページに記載された公式ハッシュ（以下を参照）をコピー。
-
PowerShell で次のコマンドを実行し、計算結果と比較します。
powershell
Get-FileHash -Path .\Dockpit-Setup.exe -Algorithm SHA256 | Format-Table -AutoSize -
公式ハッシュ（2026‑07‑01 更新）
3F7A9C2D4E6B8F1A0C3D5E7F9B2A4C6D8E0F1A2B3C4D5E6F7A8B9C0D1E2F3A4 -
ハッシュが一致すれば、ダウンロードファイルは改ざんされていません。
ポイント：ハッシュ不一致の場合は再度公式ページから取得し、それでも一致しない場合はネットワークやミラーサーバーに問題がある可能性があります。
管理者権限でのインストール手順
Dockpit-Setup.exeを右クリック → 「管理者として実行」- インストーラ画面が表示されたら「次へ」をクリックし、利用規約に同意。
- インストール先はデフォルトの
C:\Program Files\Dockpitで問題ありません（別ドライブへの変更も可）。 - 「インストール」ボタンを押すと自動的に必要なサービスが登録されます。
ポイント：管理者権限がないと、Hyper‑V の仮想スイッチやネットワークブリッジの作成に失敗します。
カスタム設定項目（デフォルト推奨）
| 項目 | デフォルト | 推奨設定 | 補足 |
|---|---|---|---|
| コンテナランタイム | Docker Engine (Moby) | 変更不要 | Dockpit® の公式ドキュメントに準拠 |
| 自動起動 | 有効 | 有効 | Windows 起動時にサービスが自動開始 |
| ネットワークブリッジ名 | dockpit0 |
デフォルトのまま | 特別な要件が無い限り変更不要 |
| WSL 2 統合 | 有効 | 有効 | Linux コンテナをシームレスに利用可能 |
要点：デフォルト設定でインストールすれば、実務環境ですぐに使用開始できます。
初回起動手順と基本操作の検証
インストールが完了したら Dockpit® を起動し、Docker CLI が正常に機能するか確認します。ここでは、サービスの起動からサンプルコンテナ実行までを具体的に説明します。
初回起動手順
- スタートメニュー → Dockpit® → Dockpit Dashboard を選択。
- ダッシュボードが表示されない場合は、管理者権限の PowerShell で次を実行します（サービス名は
DockpitService）
powershell
Start-Service -Name DockpitService
- ダッシュボード右上に 「Running」 と表示されていれば起動成功です。
ポイント：初回起動時に自動的にサービスが開始しないケースは、Hyper‑V の仮想スイッチ権限不足が原因であることが多いです（後述の対処法を参照）。
Docker CLI での動作確認
PowerShell または Windows Terminal を開き、以下コマンドを実行します。
|
1 2 |
docker version |
- 期待結果：Client と Server のバージョン情報が表示され、
Server: Dockpitと表記される。
次に公式のサンプルイメージを起動します。
|
1 2 |
docker run --rm hello-world |
- 期待結果：「Hello from Docker!」というメッセージとともに正常終了すればインストールは成功です。
ポイント：
hello-worldは最小限のイメージなので、ネットワークやボリューム設定の影響を受けません。
Docker Desktop との違い・連携ポイント
| 項目 | Dockpit® | Docker Desktop |
|---|---|---|
| UI | シンプルな Dashboard（軽量） | 豊富な GUI と設定パネル |
| リソース消費 | 約 200 MB RAM、CPU 使用率低め | 約 500 MB+ RAM、CPU 負荷が高い |
| ライセンス | 無料（商用利用可） | 無料プランあり、有償エンタープライズ版 |
| IDE 連携 | VS Code Remote‑Containers とシームレスに統合 | 同様に対応するが設定項目が多い |
要点：Dockpit® は軽量かつスクリプト駆動での利用を前提としているため、既存の IDE（VS Code、JetBrains 系）との連携はほぼ同等です。
よくあるエラー例と対処法、アップデート・メンテナンスのベストプラクティス
実務で遭遇しやすいエラーを事前に把握しておけば、トラブルシューティングが迅速になります。また、定期的な更新とメンテナンスで安定稼働を維持しましょう。
主なエラーと具体的な解決策
| エラー | 発生原因 | 推奨対処法 |
|---|---|---|
WSL 2 バージョン不一致 (wsl --list --verbose でバージョンが 1) |
デフォルトが WSL 1 に設定されている | wsl --set-default-version 2 を実行し、PC を再起動。その後 Dockpit® サービスを再起動 |
| CPU 仮想化無効（BIOS/UEFI 設定） | BIOS で VT‑x / AMD‑V がオフ | 電源を切り、BIOS に入り「Virtualization Technology」を有効化して保存・再起動 |
ネットワークブリッジ衝突（dockpit0 が既存 NIC と IP 重複） |
同一サブネットに別ブリッジが存在 | PowerShell で Remove-NetAdapter -Name dockpit0 後、Dockpit Dashboard の「Network」設定から新しいブリッジ名を指定 |
Docker コマンドが見つからない (docker : The term 'docker' is not recognized) |
PATH に Dockpit® の bin ディレクトリが未登録 | 管理者権限で setx PATH "$Env:PATH;C:\Program Files\Dockpit\bin" を実行し、ターミナルを再起動 |
| Permission denied（Hyper‑V 仮想スイッチへのアクセス） | ネットワークアダプターの権限不足 | 以下コマンドで MAC スプーフィング許可を設定（Microsoft の公式ドキュメント[^3] に準拠）。管理者権限が必要です。 |
powershell
Set-VMNetworkAdapter -ManagementOS -Name "dockpit0" -AllowMacSpoofing On
要点：上記エラーは設定ミスや BIOS の状態が原因です。手順通りに確認・修正すれば、ほぼ全てのケースで解決できます。
定期アップデートとメンテナンス手順
- 自動更新チェック（推奨頻度：週1回）
- Dockpit Dashboard → Settings → 「Check for updates」ボタンをクリック。新バージョンがあれば通知が表示されます。
- 手動アップデート
- 公式ダウンロードページから最新版インストーラを取得し、管理者権限で実行。「上書きインストール」を選択すると設定は保持されたまま更新できます。
- キャッシュクリア（月1回程度）
powershell
dockpit system prune --all --force
- 未使用イメージ・ボリュームを削除し、ディスク容量を確保します。
- ディスク容量監視
- Dashboard の「Resources」タブで使用量を確認し、残りが 10 GB 以下になる前に不要イメージを削除してください。
ポイント：定期的なアップデートとキャッシュクリアは、セキュリティパッチ適用とディスク不足防止の基本です。
参考情報・出典
[^1]: Microsoft. Windows 11 system requirements. https://learn.microsoft.com/windows/whats-new/windows-11-requirements（2026‑06‑30 参照）。
[^2]: Microsoft Docs. Enable-WindowsOptionalFeature コマンドの解説。https://learn.microsoft.com/powershell/module/dism/enable-windowsoptionalfeature（2025‑12‑15 参照）。
[^3]: Microsoft Docs. Set-VMNetworkAdapter の使用例と必要権限。https://learn.microsoft.com/powershell/module/hyper-v/set-vmnetworkadapter（2026‑01‑20 参照）。
まとめ
本稿では、Dockpit® を安全に導入・運用するための公式システム要件、WSL 2 と Hyper‑V の有効化手順、ハッシュ値によるインストーラ検証、初回起動から基本操作、よくあるエラーとその対処法、そして定期的なアップデート・メンテナンスのベストプラクティスを網羅しました。要件確認とチェックサム検証だけでも、導入時のリスクは大幅に低減できますので、ぜひ本手順をご活用ください。