ラズパイ初期設定｜ImagerでOS書込みとSSH - TsukuLab | ツクラボ

ラズパイ初期設定の全体像｜この記事でできること

完成イメージと所要時間

この記事で目指す到達点は、Raspberry Pi OS が起動し、有線LANまたはWi-Fiでネットワークにつながり、PC から SSH でログインできる状態です。
SSH はパスワード認証でも公開鍵認証でも進められるように整理します。
デスクトップ画面を見ながら触り始めたい人にも、最初からモニターなしで運用したい人にも対応できるよう、入口を分けて説明していきます。

作業時間の目安は 30〜60分 です。
内訳は、OS の書き込みに 10〜20分、初回起動と基本設定に 10〜20分、接続確認に 10〜20分 というイメージです。
Raspberry Pi Documentation - Getting started（https://www.raspberrypi.com/documentation/computers/getting-started.htmlでも、公式の流れはRaspberry Pi Imagerで書き込みと事前設定を済ませることになっています。
そこから起動確認へ進む形になっています）。

筆者のワークショップでも、この全体像を先に共有しておくと途中で焦る人が減ります。
とくに初回起動では、画面が出るまで待つ時間や、SSH で応答が返るまでの数分を「止まっている」と感じがちです。
あらかじめゴールが「OS起動」「ネット接続」「SSH成功」の3点だとわかっていれば、どこで詰まっているのか切り分けやすくなります。

GUIあり vs ヘッドレス

初めに決めたいのは、モニターとキーボードをつないでセットアップするか、それとも PC だけでヘッドレス構成のまま進めるかです。
どちらも正解ですが、使い始め方とその後の運用で向き不向きが分かれます。
筆者は「最初の1台なので画面を見ながら進めたい」という相談も、「置き場所の都合で最初からヘッドレスにしたい」という相談もよく受けます。
最初の1台は GUI ありのほうが不安が少ない一方、運用まで見据えるとヘッドレスのほうが手間が減る場面が多い、というのが実際のところです。

項目	GUIありセットアップ	ヘッドレスセットアップ	手動ファイル方式
必要機材	モニター・HDMI・キーボード・マウス	PCとネットワーク、microSDのみ	PCとmicroSDのみ
初心者向け	高い	高い（Imager活用前提）	低め
初回の見通し	画面を見ながら進められる	起動後の見えない待ち時間がある	成功条件がわかりにくい
Wi-Fi設定	初回起動後でも可能	Imagerで事前設定可能	Bookwormでは混乱しやすい
SSH設定	起動後にraspi-configでも可	Imagerで事前設定可能	旧来の空ファイル手法は補助的
向いている人	最初の1台を確実に動かしたい人	周辺機器を増やしたくない人	旧手順を理解済みの中級者

GUI ありの利点は、起動しているか、ネットワークにつながったか、どの設定画面にいるかを目で追えることです。
Linux に触れるのが初めてなら、まず1回はこの流れを体験しておくと全体像がつかめます。
いっぽうで、実運用ではラズパイを棚やケースに入れて使うことが多く、毎回モニターをつなぐのは手間になります。
DevelopersIO - PCからSSH接続するまでの手順DevelopersIO - PCからSSH接続するまでの手順のように、いまはRaspberry Pi Imagerのカスタマイズでユーザー、ホスト名、Wi-Fi、SSH を先に入れられます。
ヘッドレスでも出だしから無理のない構成にできます）。

ヘッドレスを選ぶと、机の上にモニターやキーボードを広げずに済みます。
ラズパイ本体、microSD、電源、PC があれば進められるので、作業場所を選びません。
複数台を立ち上げるときもこの差が効いてきます。
1台ずつ画面をつないで初期設定するより、事前設定済みの microSD を用意して SSH で順番に入るほうが流れが途切れません。

Bookworm（Debian Bookworm ベースの Raspberry Pi OS）以降、Imager を使った事前設定が導線として使われるケースが増えています。
旧来の「boot パーティションにファイルを置く」手順は、環境やイメージによって動作が異なる報告があるため、入門向けには Imager を主軸に案内する方が誤解が少なくなります。
とはいえ、手動ファイル方式は仕組みを理解している中級者の補助手段としては依然有用です。
ここでは「Imager を基本ルートとし、理解がある人向けに代替手順がある」ことを前提に説明します。

NOTE

Bookworm 以降、Imager による事前設定が一般的に使われるケースが増えています。
旧来の boot にファイルを置く手順は、環境やイメージによって動作が異なる報告があるため、入門向けには Imager を主軸に案内するほうが混乱を避けやすいです。
とはいえ、手動ファイル方式は仕組みを理解している中級者の補助手段としては有用です。
この記事の対象は、Raspberry Pi を初めて触る人、できれば周辺機器を増やさず PC から使い始めたい人です。
その前提なら、GUI ありかヘッドレスかを最初に選び、どちらの場合もRaspberry Pi Imagerで事前設定を入れて進めるのが、いちばん筋の通った出発点になります。

[備忘録] Raspberry Piの初期設定をしてPCからSSH接続するまでの手順｜ DevelopersIO

dev.classmethod.jp

必須アイテム

まず揃えておきたいのは、Raspberry Pi本体、microSDカード、microSDをPCに挿すためのカードリーダー、電源、そしてインターネットに接続できるPCです。
この記事の流れではRaspberry Pi ImagerでOSを書き込むため、PCとカードリーダーは実質セットで必要になります。
ノートPCにmicroSDスロットがない場合は珍しくないので、USB接続のカードリーダーを1つ用意しておくと作業が止まりません。

本体はRaspberry Pi 4でもRaspberry Pi 5でも進められますが、初期設定の段階で見落とされやすいのが電源です。
Pi 4/5世代は5V 3A級の給電が実運用の前提になっていて、ここが弱いとOSの書き込みや起動自体は通っても、その後に不安定さが出ます。
筆者の体感でも、5V 3Aの純正または準拠アダプタに替えただけで「起動はするが途中で落ちる」「USB機器の認識が途切れる」といった症状が収まる場面が多いです。
原因がOS設定に見えて、実際は電源だったというのは初回セットアップでよくあるつまずきどころです。

ネット環境も必須です。
OSイメージの取得、初回のアップデート、SSH接続の確認まで含めると、オフラインでは流れが分断されます。
有線LANを使うならルーターやスイッチに空きポートが必要ですし、Wi‑Fiのみで進めるならPC側でSSID、パスワード、国コードを事前に把握しておく必要があります。
Raspberry Pi Documentation - Configuration（https://www.raspberrypi.com/documentation/computers/configuration.htmlでも、ヘッドレス初期設定ではWi‑FiとSSHをOS書き込み時に入れておく流れが案内されています）。

あると便利なもの

画面を見ながら進めるルートなら、HDMIケーブルとモニター、USBキーボード、USBマウスもあると進行がはっきりします。
最初の1台で「いま起動しているのか」「Wi‑Fiに入れたのか」を目で確認したい場合は、この構成の安心感が大きいです。
ヘッドレスでも進められますが、ネットワーク設定を1か所でも取り違えると、起動後の状態が見えないまま待ち時間になりやすいんですよね。

一方で、ヘッドレス前提なら周辺機器を無理に増やす必要はありません。
PC、microSD、カードリーダー、電源、ネットワークが揃っていれば初期設定までは進められます。
複数台を並行して準備する場面では、この身軽さが効きます。
モニターやキーボードを都度つなぎ替えるより、Imagerで設定を入れたmicroSDを順に作って起動させるほうが、机の上も手順も散らかりません。

USB有線LANアダプタや予備のLANケーブルも、環境によっては役立ちます。
Wi‑Fi設定が通っているか切り分けたいときに、有線で一度つながるだけで原因の範囲を一気に絞れます。
初回だけEthernetでつないで、セットアップ後にWi‑Fi運用へ移すやり方は、ワークショップでも成功率が高い進め方です。

microSDカードの容量と上限

microSDカードは、Raspberry Pi OSのデスクトップ版を入れるなら32GB以上、Raspberry Pi OS Liteなら16GB以上が目安です。
公式のRaspberry Pi Documentation - Getting started（https://www.raspberrypi.com/documentation/computers/getting-started.htmlでもこの容量が案内されています。
初回セットアップ後のアップデートや追加パッケージを考えると、デスクトップ版で32GBを切る構成は余裕が小さくなります）。

容量だけでなく、どのOSを入れるかで体感が変わります。
GUIありでブラウザや設定画面まで使うなら、32GB以上にしておくと空き容量を気にせず進めやすくなります。
Liteは軽量ですが、後からツールを追加すると16GBでも埋まり方は意外と早いです。
学習用に何度か書き直すつもりなら、32GBのカードを基準にしたほうが運用の見通しが立てやすいと言えます。

上限は2TB未満です。
2TBを超えるmicroSDカードはMBR制限により対応外と整理しておくと混乱しません。
大容量カードを流用したくなることはありますが、初期設定用途では容量を盛るより、まずは素直に32GB以上の扱いやすいカードを使ったほうが手順の切り分けが明快になります。
OS書き込みに失敗したときも、カードそのものの特殊条件を疑わずに済みます。

電源・ネットワーク構成のポイント

電源は「5Vで給電できる」だけでは足りず、Pi 4/5世代では5V 3Aクラスを前提に考えるのが安全です。
スマホ充電器をそのまま流用すると、電圧降下や供給不足で起動ループ、再起動、USB機器の不調につながります。
見た目は同じUSB Type-Cでも中身の余裕が違うので、ここを削るとトラブルの切り分けが一気に難しくなります。
OS、Wi‑Fi、SSHの設定を何度見直しても安定しないとき、電源を変えたら通ったというのは珍しくありません。

ネットワークは、有線LANが使えるなら初回だけでもEthernet接続のほうが安定します。
IPアドレスの取得やSSH接続の確認まで一直線で進められるので、Wi‑Fi設定の打ち間違いを疑う場面が減ります。
特にヘッドレスでは、起動後に何が起きているか見えないぶん、有線の安心感は大きいです。

Wi‑Fiのみで進める場合は、SSIDとパスワードに加えて国コードをJPで入れる前提で準備しておくと流れが止まりません。
ここが抜けると、OSは書き込めているのに無線だけ上がらず、SSH接続の段階で足踏みしがちです。
記事本編では後で具体的に設定していきますが、準備物の段階で「ネットワーク情報も部品の一部」と見ておくと、物だけ揃っていて進めない状態を避けられます。

raspberry-pi-imagerでosを書き込む">Step 1: Raspberry Pi ImagerでOSを書き込む

Imagerの入手とインストール

OS書き込みは、公式が案内しているRaspberry Pi Imagerから始めるのがいちばん素直です。
Raspberry Pi Documentation - Getting started（https://www.raspberrypi.com/documentation/computers/getting-started.htmlでも、このツールを起点にOSの選択、書き込み、検証まで進める流れが示されています。
いまの初期設定は、あとから細かいファイルを手で置くより、Imagerの画面に沿って進めたほうが手順の抜けが出にくくなります）。

記事執筆時点（例: 2026-01-17）で v2.0.4 の利用例が確認できました。
Imager は頻繁に更新されるため、実際には公式サイト実際には公式サイトから最新版を取得して使ってください。
ここで重要なのは、書き込みとベリファイまで一貫して進められる公式ツールであることです。

筆者のワークショップでも、最初の1枚はこの公式ツールに統一しています。
参加者ごとに別ツールが混ざると、画面の名称も手順もずれて説明が通りにくくなります。
Imagerなら「次にどこを触るか」が全員で揃うので、つまずいた場所の切り分けが早くなります。

デバイスとOSの選択

起動したら、まず「Device」で使うRaspberry Piのモデルを選びます。
ここは実機に合わせるのが基本です。
たとえばRaspberry Pi 4を使うのに別世代の項目を選ぶと、後の説明と画面が噛み合わなくなります。
モデル名がわかっているなら、先にここを確定させるとOS候補も整理されます。
続いて「Operating System」では、Raspberry Pi OS（32-bit）またはLiteを選びます。
デスクトップ画面を使う予定ならデスクトップ版（32-bit）を、SSH中心で軽く組みたいなら Lite を選ぶと迷いが少なくなります。
なお Imager は頻繁に更新されるため、必ず公式サイト必ず公式サイトから最新版を取得してください（参考: 例として 2026-01-17 時点で v2.0.4 を確認）。
続いて「Operating System」では、Raspberry Pi OS（32-bit）またはLiteを選びます。
デスクトップ画面つきで進める予定ならRaspberry Pi OS（32-bit）、SSH中心で軽く組みたいならLiteという分け方で考えると迷いません。
前のセクションで触れた容量の目安ともここがつながっていて、GUIまで入る構成か、CLI中心で始めるかでmicroSDの使い方も変わります。

ここがポイントです。
最初の1台で「起動してから画面を見て確認したい」なら、素直にRaspberry Pi OS（32-bit）を選んだほうが進行が読み取りやすくなります。
一方で、複数台をヘッドレスで並べるならLiteの軽さが効きます。
筆者の経験では、学習用の1台目はデスクトップ版、用途が固まっている2台目以降はLite、という流れが失敗を減らせます。

Storage（書き込み先）の選択

「Storage」では、書き込み先のmicroSDカードを選びます。
この操作がいちばん神経を使う場面です。
Imagerは選んだストレージを消去してOSを書き込むので、PCの内蔵ドライブを選ばないことが絶対条件になります。

カードリーダー経由でmicroSDを挿すと、容量やドライブ名が表示されます。
ここで、手元のカード容量と表示内容が一致しているかを見ます。
たとえば32GBのカードを挿しているのに、それより明らかに大きい内蔵SSDらしき表示が出ていたら、その選択は止めるべきです。
画面を急いで流すと、この確認を飛ばしがちです。

筆者の教室では、SDの選択ミスを防ぐために、作業中は「接続している外部ストレージはSDだけ」の状態にしてもらっています。
USBメモリや外付けSSDが同時に刺さっていると、候補が増えて一気に見分けがつきにくくなります。
実際、この一手間だけで書き込み先の取り違えは目に見えて減ります。
カードリーダーを挿す前に余計な外部ストレージを外しておくと、Storage一覧に出る候補そのものが絞られます。

NOTE

Storage を選ぶ直前に、PC 側で接続中の外部ストレージが何かを口に出して確認すると、選択ミスを防げます。講座ではこの一呼吸で操作ミスが減ります。

WriteとVerify

Device、OS、Storageの3つが揃ったら、「Write」で書き込みを始めます。
途中で確認ダイアログが出たら、消去対象がmicroSDで合っているかをもう一度見ます。
ここで問題なければ、OSイメージの書き込みが進みます。

書き込みが終わったあと、そのままベリファイ（Verify）まで通すのが基本です。
Imagerの良いところは、書き込いて終わりではなく、検証まで同じ流れで実施できることにあります。
見た目では成功していても、カードの状態や接触でエラーが混ざることがあります。
初回起動で反応がないと、電源やネットワーク設定を疑いたくなりますが、実際には書き込み直後の検証不足が原因だった、という場面は珍しくありません。

筆者は、起動しないカードを何枚も見てきましたが、最初に見るのはベリファイを通したかどうかです。
ここを省くと、トラブルの入口が広がります。
OSの問題なのか、Wi‑Fi設定なのか、電源なのかが曖昧になるからです。
逆に、書き込みと検証を通してあれば、次の切り分けがぐっと進めやすくなります。

書き込み先を間違えないコツ

書き込み先の誤選択は、初心者だけの失敗ではありません。
作業に慣れてくるほど、画面を見たつもりで次へ進んでしまいます。
防ぎ方は単純で、候補を減らして、確認ポイントを固定することです。

まず、外部ストレージをmicroSDだけに絞ること。
次に、Storageに表示された容量と、手元のカード容量が一致しているかを見ること。
この2点だけでも事故率は大きく下がります。
さらに、ノートPCの内蔵ドライブは容量が大きく表示されることが多いので、「今回使うカードの容量より明らかに大きいものは選ばない」と決めておくと判断が速くなります。

筆者が現場で案内するときは、Writeを押す前に「これはPCの保存先ではなく、いま挿したSDか」を言葉で確認してもらいます。
頭の中だけで済ませるより、声に出したほうが見落としを拾えます。
地味ですが、こういう確認動作が初期セットアップの成功率を支えます。
ここを丁寧に通しておくと、この後の初回起動やSSH接続のトラブルも切り分けやすくなります。

Step 2: 初回起動前にカスタマイズする｜ユーザー名・Wi‑Fi・SSH

ここからは、OSを書き込んだmicroSDに初回起動前の設定を入れておく段階です。
Raspberry Pi Imagerでは、書き込み直前または書き込みフローの途中で表示される歯車アイコンの設定から、ヘッドレス運用に必要な項目をまとめて投入できます。
モニターやキーボードをつながずに始めるなら、この事前設定の完成度がそのまま初回接続の通りやすさに直結します。

前の手順でDeviceOperating SystemStorageを選び、書き込み先の確認まで済ませたら、そのままカスタマイズ画面に進みます。
ここで設定を入れてから書き込み、ベリファイまで通しておくと、起動後の切り分けがぐっと明確になります。
逆に、ホスト名やWi‑Fi、SSHを後回しにすると、「起動していない」のか「ネットワークに出ていない」のかが見えづらくなります。

ホスト名とユーザー/パスワードの設定

歯車の設定画面では、まずホスト名を決めます。
複数台を扱う予定がなくても、あとで自宅LAN上から見分ける場面が出てくるので、用途が連想できる名前にしておくと混乱を避けられます。
たとえば検証機なら testpi、NAS用途なら fileserver-pi のように、役割がにじむ名前だと一覧で埋もれません。

続いて、ユーザー名とパスワードを設定します。
ここは古い記事の記憶をいったん捨てるところです。
現行のRaspberry Pi OSでは、旧来の初期ユーザー名と初期パスワードを前提に考えないほうが安全で、Imagerで自分のユーザーを作る流れが素直です。
ユーザー名は短くても構いませんが、あとでSSHログインするときに毎回打つので、無理に凝った名前にしないほうが実運用で詰まりません。

同じ画面で、タイムゾーンとロケールも合わせて入れておきます。
タイムゾーンは日本ならAsia/Tokyo、ロケールは日本語環境に寄せるなら日本を選ぶ流れです。
ここを最初から揃えておくと、ログの時刻と手元の時計が合わずに戸惑う場面を減らせます。
講座の経験上、通信や起動自体は成功しているのに、時刻表示のズレで「設定に失敗したのでは」と不安になる方が少なくありません。

Wi‑Fi

Wi‑Fiを使う構成では、SSIDとパスワードをImagerに事前入力しておきます。
起動後に画面を出して設定する手順もありますが、ヘッドレスでは最初からネットワークに乗ってくれないと次の一手が打ちにくくなります。
Raspberry Pi Documentation - Configuration（https://www.raspberrypi.com/documentation/computers/configuration.htmlでも、こうした初期設定を事前に投入する流れが案内されています）。

ここで見落としやすいのが国コードです。
日本で使うなら JP を必ず指定します。
これは見た目の地域設定ではなく、無線の規制域と利用できるチャンネルに関わる項目です。
SSIDとパスワードが正しくても、国コードが空欄だったり別の国になっていたりすると、接続の入口でつまずきます。
筆者のワークショップでも、Wi‑Fiがつながらないときはパスワードより先に国コードを確認する場面が何度もありました。

SSIDの入力では、大文字小文字と記号をそのまま合わせることが基本です。
家庭内のルーター名は見慣れているぶん、思い込みでタイプして1文字違うことがあります。
とくにスマートフォンでは見えていた表記と、ルーター管理画面に登録された正式なSSIDが少し違う例もあります。
手入力の不安があるなら、PC側で確認したSSIDをそのまま転記するほうがぶれません。

WARNING

Wi‑Fi 設定でつながらない場合、SSID・パスワード・国コードのいずれかが誤っていることが多いです。
3点をセットで確認すると原因を絞りやすく、再書き込みの回数を減らせます。

SSHの有効化

ヘッドレスで進めるなら、SSHもImagerの段階で有効化しておきます。
起動後にネットワークへ接続できていても、SSHが閉じたままだとPCから入れません。
初回セットアップでは、この「ネットワーク」と「SSH」の両輪が揃って初めてリモート操作の入口が開きます。

Imagerでは、SSHの有効化とあわせてパスワード認証か公開鍵認証かを選べます。
まず一台を確実に通したいなら、ユーザー名とパスワードでログインする形でも構いません。
接続先が見えたか、ホスト名で引けるか、IPで入れるかといった基本の確認を優先できるからです。
初回SSH接続では、PC側で接続先のホスト鍵確認が表示されることがあります。
その場合は内容を確認して進めれば問題ありません。

ホスト名で接続する場合は、たとえば ssh ユーザー名@ホスト名.local のような形を使います。
ただし .local の名前解決はmDNSに依存するので、手元のPC側で Bonjour や Avahi の系統が動いていないと名前で引けません。
そのときはラズパイの不具合と決めつけず、ルーターのDHCP一覧などで割り当てIPを見て、IPアドレス指定で接続するほうが早く進みます。
筆者も教室では、名前解決で粘るより先にIP確認へ切り替えることがよくあります。

公開鍵認証のみを許可する場合

継続運用まで見据えるなら、Imagerで公開鍵認証のみを許可し、パスワードログインを無効化する構成も選べます。
設定項目としては、PC側で作成済みの公開鍵を貼り付け、SSH認証方式を鍵ベースに寄せる流れです。
サーバー用途や、今後もLAN内で何度もログインする使い方なら、この方法の快適さが効いてきます。

鍵方式は最初に一手間ありますが、運用が始まると毎回のパスワード入力がなく、手が止まりません。
ワークショップでもこの構成は評判がよく、複数回ログインする作業になると差がはっきり出ます。
とくにアップデート、設定変更、ファイル転送を短い間隔で繰り返す日は、認証のたびにパスワードを打たないだけで作業の流れが崩れません。

公開鍵を使う場合は、PC側の秘密鍵と対になる公開鍵をImagerに貼り付けます。
貼るのは公開鍵だけで、秘密鍵はPCの中に残します。
この向きが逆になると成立しません。
すでにMacやLinuxで ~/.ssh/id_ed25519.pub や ~/.ssh/id_rsa.pub を使っているなら、その中身を使う形が一般的です。
WindowsでもOpenSSHを使って同じ考え方で進められます。

一方で、まだ鍵を作っていない段階で無理に公開鍵認証だけへ寄せると、PC側の鍵管理まで同時に覚える必要が出ます。
学習の一台目なら、まずパスワード認証で初回接続まで通し、運用が落ち着いたところで鍵へ切り替える進め方も現実的です。
複数台を管理する段になると、鍵方式の恩恵が見えやすくなります。

Bookworm 世代の Raspberry Pi OS では、旧来よく紹介されていた「boot 直下に空の ssh ファイルを置く」「wpa_supplicant.conf を置く」といった手動ファイル方式が、環境やイメージによっては期待どおり動かない事例があります。
公式の流れとしては Imager による事前設定を使う選択肢が整理されているため、入門者向けには Imager を第一選択肢として案内するのが実務上わかりやすいです。
とはいえ、手動方式を理解しておくとトラブルシュートの幅が広がるため、補助的に知っておく価値はあります。

Step 3: ラズパイを起動してネットワークに参加させる

microSDをRaspberry Pi本体に挿したら、LANケーブルかWi‑Fiの前提を整えてから電源を入れます。
ここでの狙いは、起動そのものよりもネットワークに無事参加できたかを見極めることです。
ヘッドレス構成では画面がないぶん、反応が見えず不安になりがちですが、前の手順でRaspberry Pi Imagerから Device、OS、Storage を選び、書き込みとベリファイまで通していれば、あとは起動完了を待ってIPアドレスを探す流れになります。

もしここでまったく反応が出ない場合は、起動後の調査に入る前に、そもそもの書き込み工程へ立ち返ると近道です。
Raspberry Pi Imagerの導入後に Device、OS、Storage の選択を進めた際、書き込み先のStorageをPC内蔵SSDや別のUSBメモリと取り違える事故は珍しくありません。
筆者も講座では、書き込みボタンを押す直前に「容量と型番がmicroSDと一致しているか」を必ず声に出して確認しています。
ベリファイまで終わっていれば書き込みミスの切り分けが進めやすく、起動しないときに疑う場所も絞れます。

Ethernet（有線）の利点

最初の一台では、筆者は「まず有線」を強く勧めています。
Ethernet でつなぐと、電源投入後にルーターから DHCP で IP アドレスが配られる流れが素直で、Wi‑Fi まわりの切り分けを一時的に脇へ置けるからです。
起動したのに見つからないのか、まだ起動途中なのか、Wi‑Fi 認証で止まっているのかといった論点が減るので、初期セットアップの通過率が上がります。
有線で参加した Raspberry Pi はルーターの管理画面にホスト名付きで現れることが多く、SSH の入口まで一直線につながることが期待できます。
なお、Bookworm 世代以降の手動ファイル方式は環境やイメージによって動作が異なる報告があるため、入門者には Imager を基本ルートとして案内するほうが混乱が少ない点を覚えておいてください。
Wi‑Fiで起動する場合は、有線より少し待つ前提で構えておくと落ち着いて進められます。
初回起動ではOS展開と初期設定が走るうえに、そのあと無線LANへの接続確立が続くため、電源投入直後にすぐ見つからなくても不自然ではありません。
とくにヘッドレスだと進行状況が見えないので、短い間隔で電源を抜き差ししてしまう人が多いのですが、ここで待てるかどうかが分かれ目です。

確認先として最短なのは、やはりルーターのDHCPリース一覧です。
SSIDやパスワードをImagerで正しく入れてあれば、接続が通った時点で新しい端末として現れます。
ホスト名を設定していればその名前で見つかることもあり、見当たらなければMACアドレスや接続時刻で絞り込めます。
筆者も教室では、無線接続の初回確認はPC側のターミナルより先にルーター画面を見ることが多いです。

Raspberry Pi Documentation - Configuration（https://www.raspberrypi.com/documentation/computers/configuration.htmlでも、ヘッドレス構成ではOS書き込み時の事前設定を起点に進める流れが整理されています。
Bookworm世代では手動ファイル方式よりImager側でWi‑FiとSSHをまとめて仕込んでおくほうが見通しがよく、起動後に「何を疑うべきか」が明確に残ります）。

NOTE

Wi‑Fi で見つからないときは「まだ接続待ちなのか」「そもそも起動していないのか」を分けて考えてください。
DHCP 一覧に現れない場合は、microSD や電源周りのチェックも同時に行うと効率的です。

初回起動の所要時間と注意

初回起動では、書き込んだイメージをそのまま読むだけではなく、展開や最終設定が入るため少し時間がかかります。
ここで焦って電源を切ると、正常な初期化の途中で止めてしまい、その後の挙動が不安定になります。
何も見えないヘッドレス運用ではとくに、この待ち時間を「失敗」と勘違いしないことがポイントです。

この段階で見直すべき情報は、起動後の操作ではなく、起動前に作ったmicroSDの内容です。
前述の通り、Raspberry Pi Imagerで Device、OS、Storage を選び、書き込みとベリファイまで終えていれば、microSDの土台は信頼できます。
逆に、急いでベリファイを省いたカードは、起動しないときに「OSの設定が悪いのか、書き込みが壊れていたのか」が混ざってしまいます。

microSDの容量選びも初期の安定感に関わります。
Raspberry Pi Documentation - Getting started（https://www.raspberrypi.com/documentation/computers/getting-started.htmlでは、Raspberry Pi OSは32 GB以上です。
Raspberry Pi OS Liteは16 GB以上が目安として整理されています。
容量不足そのものが即座に起動失敗へ直結するわけではありませんが、余裕のないカードはアップデートや追加パッケージの段階で詰まりやすく、最初の一枚として扱いづらくなります）。

起動しないときに意外と多いのが、OS選択そのものの食い違いです。
デスクトップ画面を出すつもりでLiteを書いていたり、逆に軽量運用のつもりでデスクトップ版を書いていたりすると、想定と現実の差が広がります。
症状だけを見ると不具合に見えても、実際にはImagerで選んだOSが違っていた、という場面は珍しくありません。

電源不足・起動失敗の典型症状

電源が足りないときの症状は、見た目に特徴があります。
起動ループを繰り返す、虹色の画面から先へ進まない、画面に稲妻アイコンが出る、USBキーボードやUSBストレージの反応が不安定になる、といった形です。
Raspberry Pi 4世代以降は電源条件がシビアで、5V 3A級の給電を前提にしたほうが切り分けが速く進みます。
理論上は15Wを供給できる計算なので、本体に加えてUSB機器ぶんの余裕も持たせやすくなります。

筆者の経験でも、起動しない原因をOSやネットワーク設定だと思って追っていたら、実際はスマートフォン用の弱いUSB電源だった、ということが何度もありました。
LEDは点くので「通電しているから大丈夫」と見えますが、それだけでは足りません。
起動の山場で電圧が落ちると、カードは読めているのに先へ進めない、という中途半端な止まり方になります。

それでも起動しない場合は、microSDの書き込みエラーやカード相性を疑う順番が自然です。
Imagerで同じOSをあらためて書き込み、ベリファイまで通しても改善しなければ、別のmicroSDへ切り替えると切り分けが進みます。
ここでも、最初の書き込み先を取り違えていないかという基本確認が効いてきます。
Storage選択の見間違いは地味ですが、初回セットアップでは最後まで尾を引く典型的なつまずきです。

Step 4: SSHで接続する｜Windows/Mac/Linux共通

接続先の見つけ方

SSH の基本形は ssh ユーザー名@ホスト名、または ssh ユーザー名@IPアドレス です。
Raspberry Pi Imagerのカスタマイズでホスト名を入れてあれば、まずは raspberrypi.local のような名前で試せます。
たとえばユーザー名を takuya、ホスト名を raspberrypi にしたなら、接続コマンドは ssh takuya@raspberrypi.local です。

ここでつまずきやすいのが .local です。
これは mDNS で名前解決される前提なので、同じ家庭内 LAN でも raspberrypi.local で届くときと届かないときがあります。
名前で見つからないなら、Step 3 で確認した DHCP リース一覧の IP アドレスをそのまま使うほうが早道です。ssh takuya@192.168.1.23 のように打てば、mDNS を通さずに直接接続できます。

筆者はワークショップで複数台を一度に立ち上げることがありますが、mDNS が不調なネットワークでは arp -a で近隣機器の一覧を出し、MAC ベンダ名からラズパイらしい端末に当たりを付ける方法が実用的でした。
ルーター画面に入れない現場でも候補を絞り込めるので、IP を拾う手段として覚えておくと役立ちます。

初回接続では、接続先のホスト鍵を登録する確認が出ます。
表示は Are you sure you want to continue connecting (yes/no/[fingerprint])? のような形で、yes と入力すると known_hosts に保存されます。
これは「この接続先を今後は既知の相手として扱う」という登録処理で、次回以降は同じ確認が出なくなります。

Windowsの例

Windows ではPowerShellコマンドプロンプトWindows Terminalのどれからでも、OpenSSH クライアントを使って接続できます。
いまの Windows では追加ソフトなしで通る場面が多く、まずは標準のターミナルから試す流れで問題ありません。

ホスト名でつながる場合は、たとえば次のように入力します。

ssh takuya@raspberrypi.local

.local で解決できないときは、IP アドレスを使います。

ssh takuya@192.168.1.23

初回はホスト鍵の確認に続いて、パスワード認証を有効にしている構成ならパスワード入力を求められます。
入力中は画面に何も表示されませんが、そのまま打って Enter で進みます。
受講者の方がここで「入力できていない」と感じて止まりがちですが、表示されないのが正常です。

もし ssh コマンド自体が見つからないと出たら、古い Windows 構成では OpenSSH クライアントが未導入のことがあります。
その場合でも、手順の中心は変わりません。
接続先はImagerで設定したユーザー名と、raspberrypi.local か DHCP で確認した IP アドレスです。

macOS/Linuxの例

macOS と Linux では、標準のターミナルからそのまま SSH を使えます。
接続に指定するコマンド（ユーザー名@ホスト名や IP 指定）は Windows と同様で、違いは起動するアプリがTerminalや各種端末エミュレータになる点だけです。

ホスト名で接続する例です。

ssh takuya@raspberrypi.local

IP アドレスで接続する例です。

ssh takuya@192.168.1.23

raspberrypi.local が通るかどうかは、ローカルネットワーク側で mDNS が見えているかで決まります。
DevelopersIOの SSH 接続手順記事でも .local で見つからない例が扱われていますが、現場感としてもここは珍しくない詰まりどころです。
名前解決が空振りしたら、ホスト名に固執せず IP へ切り替えると、その先の切り分けが一気に進みます。

ここまで来れば、OS 書き込み、起動、ネットワーク参加、SSH 有効化の各工程がひと通りつながったと判断できます。以後の操作は落ち着いて進めてください。

NOTE

Connection refused は SSH サービス未起動、Could not resolve hostname は名前解決の失敗を示します。
エラー文の違いを手がかりに戻る箇所を判断しましょう。

公開鍵で接続するコマンド例

公開鍵認証を使う場合の基本形は、秘密鍵ファイルを -i で指定する書き方です。たとえば Ed25519 鍵を使うなら、次のようになります。

ssh -i ~/.ssh/id_ed25519 takuya@raspberrypi.local

IP アドレスで指定するならこちらです。

ssh -i ~/.ssh/id_ed25519 takuya@192.168.1.23

この方法は、Step 2 で Imager の SSH 設定に公開鍵を入れておく構成で使います。
公開鍵認証はパスワード入力を省けるだけでなく、複数台管理時に運用を統一できる利点があります。
ヘッドレス運用では「モニターなしで確実に入れるか」が重要な通過点なので、事前に公開鍵を入れておくと安定します。

鍵ファイルの権限にも注意が必要です。
macOS や Linux では秘密鍵が他人から読める状態だと SSH が拒否することがあり、chmod 600 ~/.ssh/id_ed25519 のように所有者だけが読める設定にそろえるのが定石です。
Windows では権限の見え方が異なりますが、「秘密鍵を自分だけが扱える状態に保つ」という考え方は同じです。

ここで接続できれば、初期セットアップの山場は越えています。
Raspberry Pi Documentation - Configuration（https://www.raspberrypi.com/documentation/computers/configuration.htmlでも、ヘッドレス構成は SSH を入口に管理へ入る流れが整理されています。
実際の導入でも、この段階が通ると以後の更新や設定変更を落ち着いて進められます）。

つながらないときのチェックリスト

Wi‑FiのSSID/パスワードの入力ミスがないか（大文字小文字・記号）

最初に見るべきなのは、やはり Wi‑Fi の資格情報です。
Raspberry Pi Imagerで事前設定した SSID とパスワードが 1 文字でも違うと、起動自体はしていてもネットワークに乗れず、SSH 以前の段階で止まります。
よくあるのは、英字の大文字小文字、ハイフンとアンダースコア、末尾の空白、引用符の入れ方の勘違いです。
自宅のアクセスポイント名が似た文字列だと、2.4GHz 用と 5GHz 用の SSID を取り違えることもあります。
ラズパイ側は 2.4GHz でつなぎたいのに、5GHz 側だけの SSID を控えてしまうと見つかりません。
アクセスポイント側で MAC アドレス制限をかけている構成でも、同じように「見えているのにつながらない」状態になります。

接続先の指定も見直しどころです。raspberrypi.local を使うつもりで、実際にはImagerで別のホスト名を入れていた、という取り違えもよくあります。labpi.local のように変更したなら、その綴りどおりに SSH しないと届きません。
同じネットワークに似たホスト名の個体が複数あると、重複や打ち間違いで混線しやすくなります。

筆者の経験では、「raspberrypi.local にだけ反応しない」という場面は珍しくありません。
そのときは名前解決に粘るより、IP アドレスを直接確認して ssh ユーザー名@192.168.x.x で切り分けたほうが早く前に進めました。.local は mDNS が通ってはじめて使えるので、ホスト名の誤りと mDNS 未解決は分けて考えると整理しやすくなります。

Wi‑Fiの国コードが JP になっているか（Imager 設定を再確認）

日本で使うなら、Wi‑Fi の国コードが JP になっているかも外せません。
ここが未設定だったり別の国になっていたりすると、アクセスポイントが見つからない、つながったり切れたりする、といった形で表面化します。
ヘッドレス初期設定では画面がないぶん、症状が「SSH できない」にまとめて見えてしまうので、原因を取り違えやすいところです。

Raspberry Pi Documentation - Configuration（https://www.raspberrypi.com/documentation/computers/configuration.htmlでも、無線設定や SSH の事前構成はImagerや設定ツールから行う流れが整理されています。
Bookworm 世代では旧来の手動ファイル方式より、Imagerでの一括設定に寄せたほうが項目の抜け漏れを減らせます。
国コードもその一つで、Wi‑Fi パスワードだけ合っていても、ここがずれていると接続確認が空振りになります）。

すでに起動後に画面へ入れる状態なら raspi-config 側の無線地域設定も見直し候補です。
逆にヘッドレスのまま進めているなら、まずImagerのカスタマイズ画面へ戻って JP を入れ直し、同時に SSID とホスト名も見返すと、原因が複数重なっているケースをまとめて潰せます。

SSHが有効化されているか（Imager設定/raspi-config）

ネットワークには参加できているのに Connection refused が出るなら、SSH サービスが起動していないと読むのが素直です。
これは「ラズパイ本体までは見えているが、22 番ポートで待ち受けていない」状態なので、Wi‑Fi ではなく SSH の有効化を疑います。
Imagerの事前設定で SSH を有効にしたつもりでも、保存し忘れや設定画面の閉じ方で反映されていないことがあります。

パスワード認証で入る構成なら、ユーザー名の食い違いも同時に見直したいところです。
現行の Raspberry Pi OS では昔の既定ユーザー前提ではなく、Imagerで作成したユーザー名がそのまま入口になります。takuya で作ったのに pi で接続していれば、当然ながら通りません。
公開鍵認証にしている場合は、サーバー側の ~/.ssh/authorized_keys に正しい公開鍵が入っているか、パーミッションが崩れていないかも確認対象です。

鍵ログインでつまずくときは、接続元の指定ミスも起きがちです。ssh -i ~/.ssh/id_ed25519 ユーザー名@ホスト名 の -i に別の鍵を渡していたり、RSA 鍵を登録したつもりで Ed25519 鍵を指定していたりすると、認証だけが通りません。
秘密鍵の権限が緩すぎて SSH クライアント側に拒否されることもあります。
接続先の SSH 有効化、接続元の鍵ファイル指定、サーバー側の公開鍵配置は、3 点セットで見たほうが詰まりません。
鍵ログインでつまずくときは、接続元の鍵指定ミスがよくあります。
たとえば -i に別の鍵ファイルを渡していたり、登録した鍵タイプ（RSA / Ed25519）と指定が食い違っていると認証が通りません。
秘密鍵のファイル権限（macOS/Linux では chmod 600 など）もチェックしてください。

NOTE

Could not resolve hostname は名前解決の失敗、Connection refused は SSH サービス未起動、Permission denied は認証情報の不一致を表します。
エラーごとに疑う範囲を分けると対処が速くなります。

SDカードの書き込みエラー/選択ミス（別カードで再作成、Verifyの再実施）

設定に見当がつかないときほど、SD カードそのものへ戻る価値があります。
書き込み途中のエラーや、PC 側で別ドライブを選んでしまったケースでは、見た目には完了したようでも起動内容が壊れています。
Raspberry Pi Imagerの Verify を通していない場合は、まずそこが切り分けの基点になります。
OS イメージとカスタマイズ情報が正しく書けていなければ、Wi‑Fi も SSH も個別に追っても答えへ届きません。

容量やカードの状態も影響します。
公式のRaspberry Pi Documentation - Getting started（https://www.raspberrypi.com/documentation/computers/getting-started.htmlでは、Raspberry Pi OS は 32 GB 以上が一般的な目安とされています。
Lite は 16 GB 以上が目安です。
古いカードや書き込み回数の多いカードは、初期設定だけ不安定というより、起動そのものが揺れる印象です。
筆者も、原因がネットワークに見えていたのに、別の microSD へ焼き直しただけで通ったことが何度もありました）。

あわせて、電源の不安定さも見逃せません。
Pi 4 世代以降では 5V 3A 級の給電が前提になり、細い USB ケーブルや余裕のない AC アダプタだと、起動途中で不安定になってネットワーク参加が失敗することがあります。
SSH だけ通らないように見えて、実際には起動が最後まで安定していない、という流れです。
SD カードを作り直しても挙動が揃わないときは、書き込み先の取り違え、カード不良、電源容量不足、ケーブル不良を一つのまとまりとして疑うと、無駄な遠回りを避けられます。

初期設定後にまずやること

OSアップデートと基本設定

SSH で入れたら、まず OS を最新状態へそろえておきましょう。sudo apt update && sudo apt full-upgrade を実行して、パッケージと依存関係をまとめて更新してください。

デスクトップ版を入れたなら、用途に応じてRecommended Softwareも見直しておくと、あとから「あれが入っていない」と立ち止まらずに済みます。
日本語環境を使うなら、日本語入力の整備もこの段階で片づけたいところです。
筆者はまずタイムゾーンとロケール、日本語入力、SSH 鍵の整備までを“初日の ToDo”にしています。
時計や言語設定がずれたままだと、ログの時刻確認や日本語入力の検証で地味に消耗するからです。

公開鍵認証への移行

初回はパスワード認証で入れたとしても、継続して使うなら公開鍵認証へ寄せる価値があります。
接続元 PC で鍵を作成し、ラズパイ側の ~/.ssh/authorized_keys に公開鍵を登録しておけば、毎回パスワードを打ち込む運用から抜けられます。
作業効率の面だけでなく、認証の入口を整理できる点でも効果があります。

鍵ログインで問題なく入れることを確認できたら、パスワードログインを減らす、あるいは無効化する構成を検討します。
サーバー用途や常時起動の個体では、この切り替えを早めに済ませておくほうが安心です。
よくある間違いは、鍵の登録確認前にパスワードログインを止めてしまうことです。
先に別のターミナルでもう一度ログインできるか試して、退路を残したまま切り替えると詰まりません。

TIP

鍵認証へ移行した直後は、既存セッションを閉じる前に別ウィンドウで新しい接続を試し、退路を残して切り替えると安全です。

固定IP/DHCP予約の検討

ラズパイを試作用 PC として使うだけなら、IP アドレスは自動取得のままでも困らない場面が多いです。
一方で、ファイルサーバー、監視用ノード、カメラ記録、Web サービスの常時運用のように「いつも同じ宛先へ接続したい」用途では、IP が変わるたびに接続先を書き換えることになります。
そういう運用に入るなら、固定 IP か、ルーター側の DHCP 予約を検討する段階です。

筆者は家庭内や小規模 LAN では、まずルーター側の DHCP 予約を選ぶことが多いです。
ラズパイ本体の設定を複雑にせず、管理画面で MAC アドレスと IP の対応を固定できるからです。
複数台を並べるときも、「どの個体がどのアドレスか」を一覧で追えます。
逆に、ネットワーク設定をラズパイ単体で完結させたい構成なら、本体側で固定 IP を持たせる考え方もあります。
運用の起点がどこかで決めると混乱しません。

次に学ぶなら

初期設定が終わったら、ラズパイの面白さはここからです。
ハードウェア寄りに進むなら GPIO 制御が入口になり、LED 点滅やスイッチ入力だけでも「PC とは違う手触り」が見えてきます。
ソフト寄りなら Python でファイル操作やセンサー読み取りを書いてみると、学習内容がそのまま実機へつながります。
ワークショップでも、この一歩が入ると急に手が止まらなくなる人が多いです。

実用寄りなら、カメラをつないで定点撮影や画像保存へ進む流れもおすすめです。
机の上で完結する学習だけでなく、「自分の部屋で動くもの」を作り始めると理解が深まります。
部品選びに迷うなら、LED、タクトスイッチ、抵抗、ブレッドボードが入ったスターターキットを使うと、最初の配線テーマをすぐ試せます。
Raspberry Pi Documentation - Getting started（https://www.raspberrypi.com/documentation/computers/getting-started.htmlで基本を押さえつつ。
次は GPIO と Python を実際に触る段階へ進むのが、遠回りのない流れです）。