Immich networking guide
Immich 2.5GbE vs 10GbE: Which Network Speed?
Immich does not require 10GbE to work well, but large photo and video libraries can move enough data that network speed becomes noticeable during imports, backups and server migrations. The right upgrade depends on the slowest device in the path: client Wi-Fi, server NIC, switch, NAS, storage pool and backup target all have to participate before a faster link delivers its full value.
Quick answer
What this Immich workload needs
For most home Immich servers, 2.5GbE is the practical value tier when both the server and NAS can use it. Move to 10GbE when you regularly transfer hundreds of gigabytes, run fast multi-drive or SSD-backed storage, or need several high-speed clients at once. Do not buy 10GbE to fix a slow hard-drive pool or Wi-Fi client.
Live Amazon hardware
Current products that fit this decision
These listings come from this sprint's dedicated Amazon catalogue. Barebones systems, laptops, enclosures, adapters, unrelated accessories, ambiguous product classes and obvious multipacks are excluded by the normalizer.
Buying decision
Match the hardware to the bottleneck
Choose the network from transfer behavior, not a bigger number. The planner estimates whether your daily ingest, backup volume and storage architecture can benefit from 2.5GbE or 10GbE.
Interactive decision tool
Immich Network Speed Planner
Use the workload inputs to identify a practical hardware tier or likely bottleneck before comparing live products. Results are planning guidance; verify current Immich support and the exact hardware configuration before deployment.
Compatibility checklist
Four checks before you purchase
Use a supported deployment
Immich currently favors Linux and Docker Compose for production; full VMs are supported while Docker-in-LXC is not recommended.
Keep PostgreSQL local
Do not treat a faster network as permission to move the standard database data path onto a network share.
Verify hardware access
Quick Sync, NVENC, VAAPI and ML acceleration need the right host, drivers and container device access.
Measure before upgrading
CPU, RAM, SSD, GPU and network bottlenecks create different symptoms. Change the measured bottleneck first.
Network speed matters most during bulk movement
Ordinary photo browsing rarely needs multi-gigabit Ethernet by itself. The value appears when moving large libraries, backing up several terabytes, importing video from a workstation or rebuilding storage. Measure the tasks that keep the link busy for minutes or hours; that is where upgrading from gigabit to 2.5GbE or 10GbE can change the experience.
2.5GbE is an accessible home-server baseline
2.5GbE is widely available on mini PCs, NAS systems and inexpensive switches. It can more than double practical wired throughput over gigabit without demanding expensive optics or enterprise switching. For a family server with hard-drive media storage, it often matches the rest of the system well and leaves enough headroom for uploads and background backup traffic.
10GbE needs fast endpoints to pay off
A 10GbE link can move data quickly, but only when the server storage, NAS pool and client can keep up. A single hard drive or slow USB enclosure can become the bottleneck long before the network. Before buying 10GbE NICs and switches, test storage throughput locally so you know the network is actually what is limiting transfers.
The database should stay local regardless of network speed
Immich’s standard Docker Compose guidance does not support network shares for the PostgreSQL database data location. A faster network therefore does not make a remote database the recommended architecture. Keep the database on local reliable storage, then use Ethernet capacity for originals, backups and other bulk data paths where network storage makes sense.
Large first imports favor faster links
Migrating an existing multi-terabyte photo library can keep a network saturated for a long time. If the server and source both have fast storage, 2.5GbE or 10GbE can shorten the initial migration substantially. That benefit is episodic, so decide whether faster migration is worth permanent network cost or whether an overnight transfer is acceptable.
Backups can justify 10GbE before browsing does
A nightly or weekly backup of changed files may be modest, but full reseeds, replication and server replacements can move many terabytes. Home labs with a fast backup NAS can benefit from 10GbE even when Immich’s interactive use would be fine on 2.5GbE. Size the network for the heaviest recurring maintenance task, not just the web interface.
Switch design matters as much as NIC speed
A 10GbE NIC connected through a 1GbE switch is still a 1GbE path. Multi-gig switches also vary in the number of true 2.5/5/10GbE ports and uplink architecture. The dedicated catalogue separates NICs from switches so buyers can see the full path rather than purchasing one fast endpoint in isolation.
Copper 10GbE increases heat and power
10GBASE-T adapters and switches can run warmer and use more power than 2.5GbE gear. In a small home server or passively cooled switch cabinet, that can affect fan noise and reliability. SFP+ can be efficient in some builds but introduces its own transceiver and cabling choices. Include power and cooling in the network upgrade budget.
Wi-Fi can remain the client bottleneck
Phones and laptops often upload over Wi-Fi, so a 10GbE server link does not make a weak wireless connection ten times faster. It can still help when several wireless clients feed a fast access point or when the NAS backup path is wired. Think of the network as a chain and upgrade the segment that is actually saturated.
2.5GbE fits many HDD-based NAS pools
Several hard drives in a NAS can exceed gigabit throughput, but a small home array may not sustain 10GbE for every workload. 2.5GbE often captures a meaningful portion of the available performance without overbuilding the network. As drive count or SSD caching increases, 10GbE becomes more reasonable.
Use transfer-time math before buying
A simple estimate turns network marketing into a practical decision: divide the amount of data by realistic throughput and compare the hours saved. A 500GB weekly workflow may justify 2.5GbE, while recurring multi-terabyte transfers can make 10GbE compelling. The calculator uses this workload approach rather than assuming every large library needs the fastest standard.
Upgrade both the server and storage path deliberately
The best network upgrade is coordinated. Check the Immich host NIC, NAS NIC, switch ports, cabling, client adapters and storage speed together. Buy a 10GbE card only when the rest of the route supports it or when you have a staged plan to upgrade those components soon. Otherwise, a simpler 2.5GbE build can deliver better value.
Questions people ask
Immich 2.5GbE vs 10GbE questions
Does Immich need 10GbE?
No. Immich can run well on slower networks. 10GbE is mainly valuable for fast bulk transfers, backups and high-performance NAS paths.
Is 2.5GbE enough for Immich?
For many home servers, yes. It is a strong value tier when the server, NAS and switch all support it.
Will 10GbE make photos load faster?
It may help when network storage is the bottleneck, but database, client, disk and application latency can matter more for ordinary browsing.
Can I put the Immich database on a 10GbE NAS?
Immich’s standard Docker Compose guidance says network shares are not supported for the database data location. Keep the database local.
Do I need a 10GbE switch?
If multiple 10GbE devices need to communicate through the network, yes. A direct point-to-point link is another option for some advanced setups.
Is 10GBASE-T too hot for a mini PC?
It can add heat and power draw. Check adapter cooling, host airflow and switch placement before choosing copper 10GbE.
Should I buy a 2.5GbE or 10GbE NIC?
Choose based on actual transfer volume and endpoint speed. 2.5GbE is often the best value; 10GbE fits repeated multi-terabyte or multi-client workloads.
Does Wi-Fi limit Immich uploads?
Yes. A phone on slow Wi-Fi cannot use the full speed of a 10GbE server link. Faster wired infrastructure still helps aggregate clients and NAS traffic.
Can hard drives saturate 10GbE?
A single HDD usually cannot. Larger arrays and SSD-backed storage can approach much higher throughput, making 10GbE more useful.
How do I decide if 10GbE is worth it?
Estimate the time saved on your recurring largest transfers, then compare that value with NIC, switch, cabling, power and cooling costs.
Official references and methodology
Verify current Immich support before deployment
Cloudzat treats network recommendations as workload planning rather than an Immich software requirement. The live catalogue refreshes PCIe NICs and multi-gig switches separately. Verify exact port speeds, chipsets, host slot compatibility, cabling and switch topology before purchase.
- Immich - Requirements
- Immich - Hardware Transcoding
- Immich - Hardware-Accelerated Machine Learning
- Immich - Remote Machine Learning
- Immich - Docker Compose Installation
- Immich - System Settings
As an Amazon Associate, Cloudzat may earn from qualifying purchases. Prices, seller terms, exact configurations, firmware and software support can change.