セットアップ

Raspberry PiにRaspberry Pi OSをインストールする手順を記載する。

注意事項

ハードウェア設定

デバイス	接続先
USB接続のSSD	USB 3.0 port 1(※port 2だと、PARTUUIDが変わってしまう)

イメージファイルのダウンロード

参考

https://www.raspberrypi.com/software/operating-systems/

ダウンロード

$ curl -O URL

パラメータ	説明
URL	イメージファイルのURL(例：https://downloads.raspberrypi.com/raspios_arm64/images/raspios_arm64-2026-06-19/2026-06-18-raspios-trixie-arm64.img.xz)

チェックサム

sha256sum -c hash.txt

パラメータ	説明
hash.txt	チェックサムを記載したファイル(例： 123287c05f27b0eebd8f65456f6369b8f6635fa50a3d440a4f9f6223bf58c8e2 2026-06-18-raspios-trixie-arm64.img.xz )

ストレージへの書き込み

書き込み

$ xzcat RASPIOS.img.xz | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync

パラメータ	説明
RASPIOS.img.xz	イメージファイル(例：2026-06-18-raspios-trixie-arm64.img.xz)
sdX	デバイス名(例：sdb)

Raspberry Piの初期設定

cloud-init

/bootディレクトリ
cmdline.txt
meta-data
network-config
user-data

設定

cmdline.txt

... cfg80211.ieee80211_regdom=JP ds=nocloud;i=rpi-001

meta-data

instance-id: rpi-001

user-data

#cloud-config
manage_resolv_conf: false

hostname: HOST
manage_etc_hosts: true
packages:
- avahi-daemon
apt:
  preserve_sources_list: true
  conf: |
    Acquire {
      Check-Date "false";
    };
timezone: Asia/Tokyo
keyboard:
  model: pc105
  layout: "jp"
user:
  name: USER
  shell: /bin/bash
  lock_passwd: false
  passwd: "PASSWD"
  ssh_authorized_keys:
    - "PUBKEY"
  sudo: null
ssh_pwauth: false
runcmd:
  - [ systemctl, enable, --now, ssh ]

パラメータ	説明
HOST	ホスト名
USER	ユーザ名
PASSWD	パスワード(コマンド：openssl passwd -6)
PUBKEY	SSHのパブリックキー

network-config

network:
  version: 2
  ethernets:
    eth0:
      dhcp4: true
      dhcp6: true
      optional: true
  wifis:
    wlan0:
      dhcp4: true
      regulatory-domain: "JP"
      access-points:
        "SSID":
          password: "PSK"
      optional: true

パラメータ	説明
SSID	SSID
PSK	PSK(コマンド：wpa_passphrase SSID passphrase)

起動後

オートログイン無効

sudo raspi-config

  1 System Options
    S6 Auto Login

パッケージ更新

$ sudo apt update                                                                                              
$ sudo apt upgrade

ロケール設定

ja_JP.UTF-8に設定する。

sudo dpkg-reconfigure locales

スワップ設定

スワップをオフにする場合

$ sudo swapoff --all                                                                                               
$ sudo systemctl stop dphys-swapfile                                                                               
$ sudo systemctl disable dphys-swapfile

スワップを増やす場合

/etc/dphys-swapfile

CONF_SWAPSIZE=100

$ sudo systemctl restart dphys-swapfile

ユーザ追加

$ sudo adduser [user]                                                                                              
$ sudo usermod -a -G adm,dialout,cdrom,sudo,audio,video,plugdev,games,users,input,netdev,spi,i2c,gpio [user]

ユーザ変更

$ sudo usermod -d /home/NEWUSR -m OLDUSR
$ sudo usermod -l NEWUSR OLDUSR
$ sudo groupmod -n NEWGR OLDGR

ホスト名設定

$ sudo hostnamectl set-hostname [hostname] # /etc/hostnameなどを変更
$ sudo vi /etc/hosts

$ sudo reboot # 再起動

補足

キーボード

/etc/default/keyboard

XKBOPTIONS="ctrl:swapcaps"

HDMI出力

/boot/config.txt

hdmi_force_hotplug=1

Full HDにするには？

マルチアーキテクチャ

$ sudo dpkg --add-architecture armhf

インストール済みメディアからコピーする場合

SDカードのcfdisk

    Device       Boot      Start       End   Sectors   Size  Id Type
>>  Free space              2048      8191      6144     3M                     
    /dev/sdf1               8192    532479    524288   256M   c W95 FAT32 (LBA)
    /dev/sdf2             532480  62453759  61921280  29.5G  83 Linux

parted

(parted) p                                                                
Model: Generic Mini SD Reader (scsi)
Disk /dev/sdf: 32.0GB
Sector size (logical/physical): 512B/512B
Partition Table: msdos
Disk Flags: 

Number  Start   End     Size    Type     File system  Flags
 1      4194kB  273MB   268MB   primary  fat32        lba
 2      273MB   32.0GB  31.7GB  primary  ext4

/boot/cmdline.txt

root=/dev/mmcblk0p2

root=PARTUUID=757373e1-02

/etc/fstab

PARTUUID=9d181d35-01  /boot           vfat    defaults          0       2
PARTUUID=9d181d35-02  /               ext4    defaults,noatime  0       1

$ blkid /dev/SDX

$ sudo e2label /dev/SDX rootfs

$ sudo e2fsck -f /dev/SDX
$ sudo resize2fs