Raspberry Pi ImagerをLinuxで使う方法｜apt・snapの旧版1.xに注意、2.0.12の導入とCLI

Raspberry Pi Imagerは、Raspberry Pi用のOSイメージをmicroSDカードやUSBストレージへ書き込む公式ツールです。Linuxで使う場合、入手経路によって入る版が大きく違います。2026年10月23日時点の現行版は2.0.12ですが、Ubuntu標準リポジトリのaptで入るのは1.8.5、Snapでは1.9.6です。どちらも1.x系で、現行のRaspberry Pi OS（Trixie）に対するWi-Fi・SSH・ユーザーの事前設定を正しく書き込めません。この記事では、2.0系をLinuxへ入れる3つの方法、OSの書き込み手順、カスタマイズ項目、--cliによる書き込みを、公式ソースとUbuntu 24.04での実行結果に基づいて説明します。

まとめ：Linuxでの入手経路とバージョンの違い

• 現行版は2.0.12（2026-10-08公開）。2.0.0（2025-11-24）でUIがウィザード形式に変わり、1.x時代のCtrl+Shift+Xで開く詳細設定画面はなくなった
• Ubuntu・Debian系では、公式サイトのAppImageか、GitHub Releasesの.debを使う。Raspberry Pi OS（Trixie）上ならsudo apt install rpi-imagerで2.0.12が入る
• Ubuntuのapt（1.8.5）とSnap（1.9.6）は旧版。Imager 1.xはTrixieが使うcloudinit-rpi形式を知らないため、設定したはずのWi-FiやSSHが初回起動で反映されない
• AppImageに必要なのはlibfuse2ではなくfusermount（fuse3パッケージ）。libfuse2t64を入れても起動の問題は解決しない
• ホスト名・ユーザー・Wi-Fi・SSH・Raspberry Pi Connectは、書き込み前のカスタマイズ工程でまとめて設定できる
• コマンドラインではsudo rpi-imager --cli <イメージ> <デバイス>で書き込める。ホスト名やWi-Fiを直接指定するオプションは無く、cloud-initの設定ファイルを渡す

Raspberry Pi Imagerの現行版と2.0での変更点

GitHub Releasesで公開日を確認すると、版の流れは次のとおりです。

操作面で最も大きい変化は、1.xの「歯車アイコン」やCtrl+Shift+Xで開いていた詳細設定がなくなったことです。ホスト名やユーザーの設定はウィザードの一工程になり、書き込み時の動作（完了音・自動取り出し・匿名の利用統計）は左下の「App Options」へ移りました。2.0.12のQMLソースに登録されているショートカットは、性能データを書き出すCtrl+Shift+Pと、I/O設定や偽装容量カード向けの回避策を並べたデバッグ画面を開くCtrl+Alt+Sの2つです。デバッグ画面には「性能やデータの完全性に影響する」と警告が出るので、通常の書き込みでは触る必要はありません。

2.0.12で直った、Linux利用者に関係する不具合

2.0.12のリリースノートには、Linuxでの起動やOS設定、書き込み処理に関する修正が掲載されています。利用者に関係する主な変更は次の5点です。2.0.11.1以前で次の症状に当たったら、まず更新してください。

• WPA3専用のWi-Fiにつながらない：これまではパスフレーズから導いた鍵（PBKDF2）を保存していたため、WPA3（SAE）の交渉ができず、WPA2へ落ちるかSAE専用ネットワークで失敗していた。2.0.12からパスフレーズそのものを書き込む
• Linux MintやZorin OSでAppImageが起動しない：xcb系ライブラリの不足（#1719）と、fontconfigの不具合によるセグメンテーション違反（#1756）を、ライブラリの同梱とQt 6.11.2への更新で修正
• 中断した書き込みが成功と表示される：カスタマイズ中にキャンセルすると、書きかけのデバイスに完了画面が出ていた。途中で切れたダウンロードや不完全な.img.xzを検出した場合、成功扱いにせずエラーにするようになった。ただし、検出までに書き込み先の一部が上書きされている場合がある
• 内蔵eMMCが「SDカードリーダー」と表示される：eMMCのシステムドライブを上書きしかねない表示だった（#1658）。2.0.12でeMMCと表示する
• sudoで起動したときの設定ファイルとSSH鍵：root権限で起動しても、設定ファイルの作成とSSH公開鍵の読み込みを呼び出したユーザーとして行うよう修正された

LinuxにRaspberry Pi Imagerをインストールする方法

2026年10月23日に各配布元へ問い合わせた結果は次のとおりです。Ubuntu・Debian系では、ディストリビューション標準の経路ほど古い版が入ります。

Ubuntuのrpi-imagerパッケージは、24.04 LTSからUbuntu 26.04 LTS、26.10、次期27.04まで1.8.5+noembedのままです。Snapの発行者アカウントはwaveformで、ストア上の認証は付いておらず、stableチャンネルは2026年1月30日に公開された1.9.6から進んでいません。公式サイトが案内するx86_64以外のAppImageは、GitHub ReleasesのRaspberry_Pi_Imager-v2.0.12-desktop-aarch64.AppImageのように「desktop」と「cli」の2系統で配布されています。

AppImageで導入する手順（x86_64の各ディストリビューション）

公式ドキュメントが「Raspberry Pi OS以外のLinux」に案内している方法です。公式サイトの「Download for Linux (x86_64)」はimager_latest_amd64.AppImageを指し、2.0.12のファイルへ転送されます。このファイルとGitHubのdesktop-x86_64.AppImageは、配布されているSHA256SUMSで照合すると同じものです。

wget https://downloads.raspberrypi.com/imager/imager_latest_amd64.AppImage
chmod +x imager_latest_amd64.AppImage
# fusermountが無い場合（最小構成のUbuntu・Debianなど）
sudo apt install fuse3
sudo ./imager_latest_amd64.AppImage

Imager 2.0のAppImageは、FUSEのライブラリを内部に静的リンクしたランタイム（AppImage type2-runtime）で動きます。FUSE関連では、マウント用のfusermountコマンドとFUSEを利用できる環境が必要です。GUIの起動には描画関連の共有ライブラリも必要ですが、AppImageのランタイム自体はlibfuse.so.2を読み込みません。fusermountが無いUbuntu 24.04で起動すると、次のエラーで止まります（2026年10月23日、Docker上のUbuntu 24.04で実行）。

Error: No suitable fusermount binary found on the $PATH
Cannot mount AppImage, please check your FUSE setup.

このときに入れるのはfuse3です。古い解説が勧めるlibfuse2（Ubuntu 24.04以降はlibfuse2t64）は、2.0系のImagerには不要です。FUSEを使えない環境では、--appimage-extract-and-runを付けると一時展開して起動できます。ストレージへの書き込みには管理者権限が要るため、公式ドキュメントはAppImageをsudoで実行する手順を示しています。

.debで導入する手順（Ubuntu・Debian）

GitHub Releasesには、amd64・arm64・armhf向けの.debが公開されています。aptにファイルパスを渡すと、依存パッケージも一緒に解決されます。

wget https://github.com/raspberrypi/rpi-imager/releases/download/v2.0.12/rpi-imager_2.0.12-1_amd64.deb
sudo apt install ./rpi-imager_2.0.12-1_amd64.deb
rpi-imager --version

Ubuntu 24.04のコンテナでこの手順を実行すると、依存としてfuse3（3.14.0-5build1）が入り、rpi-imager --versionは「Raspberry Pi Imager v2.0.12」を返しました。libfuse2t64は入りません。この.debは、AppImage形式の実行ファイルを/usr/bin/rpi-imagerとして置いたものです（実測で同じ35,154,424バイト）。ほかにPolicyKitのポリシーと、rpiboot・fastboot機器用のudevルールが入ります。2.0.11.1までは依存にlibfuse2が書かれていて、32bitのRaspberry Pi OS Trixieでは依存を満たせずに入りませんでした（#1651）。2.0.12でこの依存は外れています。

注意したいのは、公式サイトの固定URLimager_latest_amd64.debです。2026年10月23日時点でもrpi-imager_2.0.4_amd64.debへ転送され、半年以上前の版が入ります。.debはGitHub Releasesから版番号付きで取ってください。Ubuntu標準の1.8.5が既に入っている場合は、apt policy rpi-imagerで入れ替わった版を確認します。

Raspberry Pi OS上で導入する手順

Raspberry Pi自体で別のmicroSDカードやUSBストレージへ書き込む場合は、公式リポジトリ（archive.raspberrypi.com）から入れます。Trixieでは2.0.12-1、Bookwormでは2.0.11-1が配布されています。

sudo apt update
sudo apt install rpi-imager

GUIのないLite版やヘッドレス運用では、CLI専用のrpi-imager-cliパッケージも選べます。rpi-imagerとは同時に入れられません（パッケージ定義でConflictsが指定されています）。USBブートでストレージを使う場合は、Raspberry Pi Flash DriveとUSBブートの設定手順でブート順の設定も確認してください。

Ubuntuのapt・Snapで入る1.xを避ける理由

旧版を避けるべき理由は、「古いから」だけではありません。ImagerがOSイメージに事前設定を書き込む方式はinit_formatというメタデータで決まり、1.xと2.xでは対応している方式が違います。公式マニフェスト（2026-10-06版のイメージを掲載）の値は次のとおりです。

リポジトリ内の文書doc/os_customisation_formats.mdによると、Imager 1.xが扱えるのはsystemdとcloudinitだけです。しかも1.xには、知らない形式をsystemdとみなして書き込む不具合があります。その結果、Trixieのイメージに1.xで設定を書き込むと、画面上は成功したように見えても、初回起動時に何も適用されません。Wi-Fiを事前設定したヘッドレス構成では、ネットワークにつながらずSSHもできない状態になります。すでに入っているImagerの版は次の方法で確認できます。

rpi-imager --version
apt policy rpi-imager
snap list rpi-imager
# 旧版を外す場合
sudo apt remove rpi-imager
sudo snap remove rpi-imager

Raspberry Pi ImagerでOSを書き込む手順

2.0のウィザードは、左の工程一覧を上から順に進める作りです。公式ドキュメントの手順は次のとおりです。

1. Device：Raspberry Piのモデル（Pi 5、Pi 4、Zero 2 Wなど）を選ぶ
2. OS：OSを選ぶ。一覧の最上位がそのモデルの推奨OS。手元のイメージは「Use custom」から選ぶ
3. Storage：書き込み先のmicroSDカードやUSBストレージを選ぶ
4. Customisation：カスタマイズに対応するOSなら、ホスト名やユーザーを設定する（後述）
5. Writing：設定の要約を確認して「Write」を押し、「I understand, erase and write」で消去と書き込みを承認する

書き込みが終わると検証（verify）が始まります。「Skip verification」で省略もできますが、公式ドキュメントは検証の完了を推奨しています。OSの選択肢は、Raspberry Pi OSのほかに「Other general-purpose OS」（Ubuntu Desktop・Server 26.04.1など）、「Media player OS」、「Emulation and game OS」などのカテゴリに分かれています。Pi 4と5のどちらを選ぶか迷っている場合は、Raspberry Pi 5 と Pi 4 の違いで対応OSと性能差を比べられます。

Storage画面の「Exclude system drives」の意味

「Exclude system drives」は、PCのOSやデータが入ったドライブを書き込み先の一覧から隠すフィルターです。公式ドキュメントは「ホストPCのデータを消して起動不能にするのを防ぐ」ためにオンのままにするよう強く勧めています。2.0.12のLinux版ソース（src/drivelist/drivelist_linux.cpp）では、lsblkの情報から次の条件でシステムドライブと判定します。

• リムーバブルでも仮想デバイスでもないドライブ（lsblkのRMとHOTPLUGが0）。内蔵SATAや内蔵NVMeのSSDはここで除外される。USB接続とSDカード（mmc）は、内蔵のカードリーダーでもリムーバブル扱い
• リムーバブルでも、/・/usr・/var・/home・/boot・/boot/firmwareのどれかにマウントされているドライブ

つまり、USB接続のSSDは一覧に出ますが、内蔵SATAのデータ用ディスクは出ません。USB SSDから起動したLinuxでは、そのSSD自体が/にマウントされているので一覧から消えます。フィルターを外して選ぶと、ドライブ名を正確に入力しないと先へ進めない確認画面が出ます。この画面が出たら操作を止め、容量・機種名・マウント先をlsblk -o NAME,SIZE,RM,HOTPLUG,TRAN,MODEL,MOUNTPOINTSで確かめてください。

OSカスタマイズで設定できる項目（ホスト名・ユーザー・Wi-Fi・SSH）

カスタマイズに対応したOSを選ぶと、書き込み前に次のサブ画面が順に表示されます。ここで設定しておくと、ディスプレイやキーボードを付けずに初回起動からネットワーク経由で操作できます。

ホスト名はmDNSで配信されるので、同じネットワーク内の端末からssh ユーザー名@ホスト名.localで接続できます。公式ドキュメントはホスト名.lanでの接続も挙げています。Localisationで選んだ首都は、Wi-Fiの規制ドメイン（国コード）の設定にも使われます。日本で使うなら「Tokyo」を選べば、タイムゾーンと規制ドメインがそろいます。SSHの公開鍵認証を選ぶと、PCのSSH設定にあるRSA公開鍵が自動で入ります。無ければ「Browse」で鍵ファイルを指定します。

パスワードなしのsudoを有効にしようとすると、2.0では警告画面が出ます。2.0.11では、利用者がパスワードなしsudoを断った場合にcloud-initへsudo: nullを書き込むよう修正されました。それまでcloud-init形式のイメージではOS側の既定値が優先され、断ってもパスワードなしsudoが有効になっていました。2.0.10以前でTrixieのイメージを書き込んで運用している場合は、/etc/sudoers.d/の内容を一度確認してください。書き込み後にAWS IoTなどへつなぐ手順は、ラズパイとAWS IoT Coreを接続する手順でSSH設定から説明しています。

手元のイメージ（Use custom）でカスタマイズ画面が出ないときの対処

自分でダウンロードした.img.xzを「Use custom」で選ぶと、2.0ではカスタマイズの工程が表示されません。どの形式で設定を書けばよいかを判断できないため、init_formatをnoneとして扱う仕様です。1.xは同じ場面でsystemd形式を決め打ちで書き込んでいたため、Trixieでは設定が黙って無視されていました。2.0はそれを避けるために、あえて何もしない動きになっています。

対処法は、公式リポジトリのdoc/local_json/create_local_json.pyで、手元のイメージ用のマニフェストを作ることです。スクリプトは公式マニフェストを取得し、ファイル名が一致するローカルイメージにメタデータを付けてos_list_local.rpi-imager-manifestを出力します。--output-jsonを省くと、実行したディレクトリに書き出されます。以下のコマンドは、リンク先のスクリプトをcreate_local_json.pyという名前で保存し、その保存先を作業ディレクトリにして実行します。

python3 create_local_json.py --search-dir ~/Downloads --verify-checksums --output-json ~/Downloads/os_list_local.rpi-imager-manifest
rpi-imager --repo ~/Downloads/os_list_local.rpi-imager-manifest

Imagerの画面から読み込む場合は、App Options →「Content Repository」→「EDIT」→「Use custom file」でこのファイルを指定します。--online --dry-runを付けて実行すると、対象になるOSの一覧だけを表示できます。公式マニフェストに無いファイル名のイメージ（自作イメージなど）は対象外です。

rpi-imager --cliでコマンドラインから書き込む方法

2.0には、GUIを起動せずに書き込むCLIモードがあります。GUI版では--cliを付けて起動し、CLI専用パッケージではrpi-imager-cliを使います。CLI専用AppImage（例：Raspberry_Pi_Imager-v2.0.12-cli-x86_64.AppImage）は、実行権限を付けてからパス付きで直接起動します。2.0.12のソース（src/cli.cpp）と--cli --helpの出力にある主なオプションは次のとおりです。

--sha256に渡すのは、配布されている圧縮ファイル（.img.xz）ではなく展開後のイメージのハッシュです。書き込みと並行して計算した値を最後に比較する方式なので、不一致で失敗した時点で書き込み先はすでに上書きされています。

書き込み元にはローカルファイルのほか、HTTPやHTTPSのURLも指定できます。以下は、対象OSに適合するuser-dataとnetwork-configを作業ディレクトリに用意済みの場合の例です。書き込み先はlsblkで確認したデバイス名を渡します。

lsblk -o NAME,SIZE,RM,HOTPLUG,TRAN,MODEL
sudo rpi-imager --cli \
  --cloudinit-userdata ./user-data \
  --cloudinit-networkconfig ./network-config \
  ./2026-10-06-raspios-trixie-arm64-lite.img.xz /dev/sdb

Ubuntu 24.04で一般ユーザーのまま実行すると、ERROR: Not running as root.とsudo rpi-imager --cliで実行するよう促す表示が出て終了しました。リムーバブルでないデバイスを指定するとDestination drive is not in list of removable volumesと表示され、候補があればその一覧が出ます。CLIにはホスト名・Wi-Fi・ユーザーを直接指定するオプションが無く、GUIのカスタマイズ画面に当たる設定は、cloud-initのファイルかfirstrun.shで自分で用意します。同じ設定のイメージを何十枚も作るIoT機器の量産や検証機の配布では、GUIより手順を再現しやすくなります。端末の台数が増えて、イメージ作成から遠隔管理までを設計する段階なら、AI/IoTソリューションの開発支援で構成から相談できます。

書き込みや初回起動でつまずいたときの確認点

Linux特有の原因と、版の違いに起因する原因が多いので、次の順に確認すると切り分けが早く進みます。

• AppImageが起動しない：No suitable fusermount binary foundならfuse3を入れる。Linux MintやZorin OSで何も表示されずに落ちる場合は、2.0.12へ更新する
• ストレージが一覧に出ない：root権限なしで起動していないか、「Exclude system drives」の条件に当たっていないかをlsblkのRM・HOTPLUG・MOUNTPOINTS列で確認する
• 設定したWi-FiやSSHが効かない：Imagerが1.xでないか（rpi-imager --version）、「Use custom」でカスタマイズを省いていないかを確認する。WPA3専用のアクセスポイントなら、2.0.12以降で書き込み直す
• 書き込みや検証が途中で失敗する：他のプロセスがカードをマウントしていないかを確かめ、カードとリーダーを替えて再試行する。2.0.11.1以前は中断を成功と表示することがあったので、心当たりがあれば書き込み直す
• SSHでつながらない：ホスト名.localが引けない環境では、ルーターの管理画面で割り当てられたIPアドレスを調べてssh ユーザー名@IPアドレスで接続する

書き込んだOSが起動した後の活用例として、広告ブロックDNSを動かすPi-holeの使い方や、ラズパイでスマートホームを自作する方法があります。

よくある質問

Ctrl+Shift+Xで詳細設定（Advanced options）が開かないのはなぜ？

2.0.0で詳細設定画面が廃止され、ホスト名・ユーザー・Wi-Fi・SSHの設定はウィザードの「Customisation」工程に移ったためです。OSとストレージを選ぶと、カスタマイズに対応したOSなら自動で表示されます。書き込み時の動作は左下の「App Options」で設定します。

Ubuntuでsudo apt install rpi-imagerを実行すると古い版が入る？

はい。Ubuntuの標準リポジトリは24.04から27.04まで1.8.5のままです。現行のRaspberry Pi OSを事前設定付きで書き込むなら、公式サイトのAppImageかGitHub Releasesの.debで2.0系を入れてください。

Raspberry Pi Imagerは日本語で表示できる？

起動時に言語を選ぶ画面はありますが、日本語訳はほとんど進んでいません。2.0.12のソースに含まれる日本語翻訳ファイル（rpi-imager_ja.ts）は、745件中704件の訳文が空です。画面の大半は英語で表示されると考えてください。

Raspberry Pi Imagerを使わずにOSを書き込む方法は？

Linuxならxz -dc イメージ.img.xz | sudo dd of=/dev/sdX bs=4M status=progress conv=fsyncでも書き込めます。ただしこの方法では事前設定が入りません。PCを使わずに書き込みたい場合は「Network Install」があります。Raspberry Pi自体がネットワークからImagerを読み込んで起動する方法なので、Imagerを使わない方法ではありませんが、PCへのインストールとカードリーダーが要りません。対応はRaspberry Pi 4B以降の主力モデルとPi 400・500・500+で、モニター・キーボード・有線LANの接続が必要です。空のストレージを挿すか、Shiftキーを押しながら電源を入れると始まります。

Raspberry Pi（arm64）自体でImagerを動かせる？

動かせます。Raspberry Pi OS（Trixie）ではsudo apt install rpi-imagerで2.0.12が入り、GitHub Releasesにもarm64とarmhfの.debとAppImageがあります。USB接続のカードリーダーを使えば、Raspberry Pi 1台で別のmicroSDカードを作れます。

関連記事

• Raspberry Pi Flash Drive（公式USBメモリ）の仕様と国内価格｜USBブート設定・fstab自動マウントの手順
• Raspberry Pi 5とPi 4の違いを比較｜スペック・性能・価格と選び方【2026年10月】
• ラズパイとAWS IoT Coreを接続する手順｜証明書・MQTT送信・SSH設定
• ラズパイでスマートホームを自作する方法｜できること・Home Assistant構成・赤外線家電の操作
• ラズベリーパイ（Raspberry Pi）でAIを動かす方法｜AI HAT+ 2・AI HAT+・AI Cameraの選び方と価格、LLM導入手順