Ubuntu 25.10でWinBoatのインストール・設定

WinBoat - Run Windows Apps on Linux with Seamless Integration
https://www.winboat.app/

GitHub - TibixDev_winboat_ Run Windows apps on 🐧 Linux with ✨ seamless integration
https://github.com/TibixDev/winboat

バージョン0.8.7時点での情報
注）2025/10/18現在、WinBoatはベータ版であり今後のバージョンアップで設定などの大幅な変更が行われる可能性があります。異なるバージョンのWinBoatをインストールする際は上記サイトを元にインストールを行い。こちらは参考程度に見ることをお勧めします。

実際にインストールを行った環境
OS : Ubuntu 25.10（最小インストール後、殆ど何もいじっていない状態）
本体 : Panasonic Let's note CFSZ6-2
スペック
　CPU : Intel Core i5-7300U
　メモリ : 8GB
　ストレージ : 256GB SSDから1TB SSDに換装済み
　GPU : 内蔵GPU Intel HD Graphics 620

• 事前準備
  • 仮想化拡張機能
  • Dockerのインストール
  • Docker Compose v2のインストール
  • dockerグループに自身を追加
  • FreeRDP（Version 3.x.x）のインストール
  • iptables/nftablesとiptable_natの有効化
• WinBoatのインストール
• WinBoatの設定
• 問題点やその解決方法
  • Windowsのインストールに失敗した
  • UIが小さい
  • 時刻がおかしい（日本時間から9時間マイナスの時刻になる）
  • キーボードの入力がおかしい（英語キーボードになる）
  • パスワードを変えたい・パスワードを変えたら起動しなくなった

事前準備

• メモリ : 最低4GB
• CPU : 最低2コア
• ストレージ : 最低32GBの空き容量

PCのスペックではなくWinBoatがWindowsに割り当てるリソースの必要量。

• 仮想化拡張機能
  BIOS/UEFIでKVMを有効にする

lsmod | grep kvm

lsmod | grep kvm

kvm_intelとかkvm_amdとか表示されれば有効化済み。
表示されない場合はBIOS/UEFIの設定画面に入り有効に設定。
BIOS/UEFIの設定画面の入り方や画面の構成や項目名はメーカーにより異なるので
使っているPCやマザボのメーカーのHPなどで確認。
項目名は大抵Virtualization TechnologyとかIntel VT-xとかAMD-Vとか表記されている。

• Dockerのインストール
  リポジトリの登録とインストール

sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

systemctl status docker

systemctl status docker

Activeの行にactive (running)と表示されていればdockerのインストール完了。

• Docker Compose v2のインストール
  Dockerのインストールで既にインストール済み。

• dockerグループに自身を追加

sudo usermod -aG docker $USER

sudo usermod -aG docker $USER

• FreeRDP（Version 3.x.x）のインストール

sudo apt-get install freerdp3-x11

sudo apt-get install freerdp3-x11

• iptables/nftablesとiptable_natの有効化
  必須ではないがネットワークの自動検出と共有ファイルシステムのパフォーマンスが向上とあるのでついでに有効化します。

echo -e "ip_tables\niptable_nat" | sudo tee /etc/modules-load.d/iptables.conf

echo -e "ip_tables\niptable_nat" | sudo tee /etc/modules-load.d/iptables.conf

　PCの再起動を行うと有効化される。

WinBoatのインストール

https://github.com/TibixDev/winboat/releases
からWinBoatのパッケージをダウンロード。
多くのLinuxディストリビューションで動作するAppImageパッケージもあるが
DebianベースのUbuntuで動作するdebパッケージが公開されているのでせっかくなのでそっちを利用。

2025/10/18時点ではバージョン0.8.7が最新なのでwinboat-0.8.7-amd64.debをダウンロード。

winboat-0.8.7-amd64.debをダブルクリックしてアプリセンターからインストールを行う。

WinBoatの設定

画面左下のUbuntuのマークをクリックしwinboatを起動する。
英語の画面の指示にしたがって設定していく。

Windowsのエディション選択画面でのSelect Languageはjapaneseを忘れずに選択。
Custom ISOの項目は自分でイメージを用意してるとかでなければ何もいじらずに進める。
（指定しなければインストール時に自動でイメージがダウンロードされる。）

Passwordの設定は4文字以上の英数字のみしか設定できないので注意。

リソースの割当画面では自分のメモリ8GBの環境だとSelect RAMに4GBを指定するとメモリ不足で
DockerコンテナがクラッシュしてWindowsインストールに失敗するので
3GB設定でインストールしインストール後に4GBに変更した。

Enable home folder sharingの設定は後で変更できるのでチェックを入れないで進めても問題ない。

インストール中は http://127.0.0.1:8006/ をブラウザで開いてもインストール状況がnoVNC（VNCクライアント）で確認可能。
インストール後も http://127.0.0.1:8006/ にアクセスすればWindowsにログインすることができる。
WinBoatからWindows Desktopなどアプリが立ち上がらなくなったときもここにアクセスすればWindowsにログインできる可能性がある。
便利なのに何故かインストール後はWinBoatアプリには案内がないのでここでブックマークしておくと便利。

問題点やその解決方法

• Windowsのインストールに失敗した
  WinBoatのウィンドウを閉じて次のコマンドを実行すると失敗した原因が表示される。

docker logs WinBoat

docker logs WinBoat

　失敗した原因が特定・解消できたら次のコマンドを実行する。

docker stop WinBoat
docker rm WinBoat
rm -rf ~/winboat
rm -rf ~/.winboat

docker stop WinBoat
docker rm WinBoat
rm -rf ~/winboat
rm -rf ~/.winboat

　画面左下のUbuntuのマークからwinboatを起動し再度設定を行う。

• UIが小さい
  WinBoatのConfiguration→Display Scalingで100%、140%、180%の3段階で設定できる。
  
  
• 時刻がおかしい（日本時間から9時間マイナスの時刻になる）
  ホームディレクトリの中の.winboat/docker-compose.ymlをテキストエディタで開き
  environment:の下の階層に「TZ: "Asia/Tokyo"」を追加し以下のコマンドを実行。
  （docker-compose.ymlはYAML形式で記述され、スペースのインデントは見た目ではなく構造を示すものとして扱われるので注意）。

cd ~/.winboat
docker compose up -d

cd ~/.winboat
docker compose up -d

• キーボードの入力がおかしい（英語キーボードになる）
  2ヶ所変更する必要がある。
  
  noVNCでの入力を日本語キーボードに設定する
  　　Windowsの設定の時刻と言語→言語と地域→日本語の右の…をクリックし言語のオプションをクリック
  　　→レイアウトを変更する→日本語キーボードを選択→PCを再起動
  
  WinBoatからアプリを開いたときの入力を日本語キーボードに設定する
  　　Windowsでレジストリエディタを開く
  　　HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Keyboard Layouts\00000411
  　　のLayout Fileの値をKBDJPN.DLLからkbd106.dllに変更し、PCの再起動を行う。
  
  
  
• パスワードを変えたい・パスワードを変えたら起動しなくなった
  一応、次の手順でパスワードを変更することが可能。
  
  Windowsの設定のアカウントから通常通りパスワードの変更を行う。
  注）設定するパスワードは4文字以上の英数字のみにしないとWinBoatからアプリが立ち上げられなくなる。
  Ubuntuでホームディレクトリの.winboat/docker-compose.ymlをテキストエディタで開き
  PASSWORD: の項目に変更したパスワードを設定。
  PCを再起動（Dockerのコンテナをrestartすればいいだけかもしれないが確認してない）。
  
  間違えて4文字以上の英数字以外のパスワードを設定してしまった場合
  WinBoatからアプリをクリックしても立ち上がらないので
  ブラウザで http://127.0.0.1:8006/ にアクセスしWindowsにログインしパスワード4文字以上の英数字に変更する。
  あとは前述のパスワード変更方法と同じ。