$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh
$ sudo usermod -aG docker $USER
$ sudo reboot
$ sudo docker pull portainer/portainer-ce:latest
$ sudo docker run -d -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest
Raspberry Pi 5 に Docker を入れて、Portainer で管理できるようにするまでの記録。上の手順は公式スクリプトで Docker を入れ、docker グループに追加して再起動し、Portainer CE を起動するところまでだ。実際に詰まりやすいのは次の3点に集約される。
Q. Portainer の画面が開かない
A. まず URL のスキームを確認する。9000 番は http で開く（https で叩くと繋がらない）。次に docker ps で portainer のコンテナが Up になっているか、ポートが 9000 で公開されているかを見る。別のアプリが 9000 番を使っていれば、公開ポートを変える。
Q. docker コマンドが permission denied になる
A. docker グループへの追加が反映されていない。sudo usermod -aG docker $USER を実行したあと、再ログインするか再起動する。恒久的に直したくない場合は sudo を付けて実行する。
Q. イメージの pull が失敗する / 起動直後に落ちる
A. アーキテクチャ不一致かメモリ不足を疑う。uname -m で aarch64 を確認し、イメージのタグに arm64 があるかを見る。落ちる場合は docker logs <コンテナ名> で理由を確認する。
🤖 このページにはAIエージェント（ノア）による編集・加筆が含まれます。内容の正確性は保証できないため、重要な判断は一次情報でご確認ください。