SelfHostPlanner
Guide 01 · Hardware

Size the workload, not the hype.

Immich's official baseline is refreshingly clear: at least 6GB RAM and 2 CPU cores, with 8GB RAM and 4 cores recommended. Start there. Upgrade only for a workload you can name.

Official baseline, checked June 18, 2026
Linux or another 64-bit Unix-like OS is recommended. Immich supports amd64 and arm64. A smooth experience—especially during upload—requires at least 6GB RAM; 8GB is recommended. The official CPU recommendation is four cores.

What actually creates load

A practical planning ladder

ProfilePlanning starting pointWhy
Personal / small family8GB RAM, 4 modern coresMatches official recommended baseline.
Large library or 10+ active users12–16GB, 6–8 coresPlanning judgment for overlapping jobs; validate under your workload.
Heavy video / large household16GB+, hardware acceleration or remote workerTranscoding strategy matters more than raw core count.

Do not put the database on slow network storage

Immich says stable Postgres performance is critical. Its database is typically 1–3GB and should ideally live on a local SSD, never a network share. If Docker resource limits are used, Postgres requires at least 2GB RAM.

Buying rule

Buy for the steady state, not the first import. Temporary ingestion can run overnight, use more workers, or use a second machine. If browsing remains responsive, a long job queue is not automatically a hardware failure.

指南 01 · 硬件

按负载规划,不跟风堆配置。

Immich 官方基线很明确:至少 6GB 内存和 2 核 CPU,建议 8GB 与 4 核。先从这里开始,只有在能说清工作负载时才升级。

官方基线(2026 年 6 月 18 日核对)
建议使用 Linux 或其他 64 位类 Unix 系统。Immich 支持 amd64 与 arm64。为保证流畅体验,尤其是上传期间,至少需要 6GB 内存,建议 8GB;CPU 建议 4 核。

真正产生负载的环节

实用规划阶梯

场景规划起点原因
个人/小家庭8GB,4 个现代核心符合官方建议基线。
大型媒体库或 10+ 活跃用户12–16GB,6–8 核针对任务重叠的规划判断,需实测验证。
大量视频/多人家庭16GB+,硬件加速或远程工作节点转码策略通常比单纯增加核心更重要。

不要把数据库放在慢速网络存储上

Immich 指出,Postgres 的稳定性能非常关键。数据库通常为 1–3GB,最好放在本地 SSD,绝不能放在网络共享上。若设置 Docker 资源限制,Postgres 至少需要 2GB 内存。

采购原则

按长期稳定负载采购,而不是按首次导入的峰值采购。首次导入可以夜间运行、增加工作进程或借用第二台机器。只要浏览仍然流畅,队列较长不一定代表硬件不足。

Primary sources