immich/docs/docs/installation/requirements.md
2022-12-20 08:54:52 -06:00

1.9 KiB

sidebar_position
1

Requirements

Hardware and software requirements for Immich

Software

:::info Podman You can also use Podman to run the application. However, additional configuration might be required on your end. :::

Hardware

  • OS: Preferred unix-based operating system (Ubuntu, Debian, MacOS, etc). Windows works too, with Docker Desktop on Windows
  • RAM: At least 2GB, preferred 4GB.
  • CPU: At least 2 cores, preferred 4 cores.

:::info Machine Learning on older CPU

TensorFlow doesn't run with older CPU architecture, it requires a CPU with AVX and AVX2 instruction set. If you encounter the error illegal instruction core dump check for your CPU flags with the command and make sure you see AVX and AVX2:

more /proc/cpuinfo | grep flags

Promox

If you are running virtualization in Proxmox, the VM doesn't have the flag enabled.

You need to change the CPU type from kvm64 to host under VMs hardware tab.

Hardware > Processors > Edit > Advanced > Type (dropdown menu) > host

Other platforms

You can use the machine learning image that is built for Non-AVX CPU. The image is community maintained and can be found in the repository below

https://github.com/bertmelis/immich-machine-learning-no-avx :::

Installation methods

There are a couple installation methods that you can use to install the application. You can choose the one that suits you the best.

  1. One-step installation (Evaluation only)
  2. Docker Compose with manual configuration (Recommended)
  3. Portainer
  4. Unraid (Community contribution)