
Immich Server Requirements and Basic Setup Guide 2025
Guide detailing the server requirements and basic setup steps to prepare an Ubuntu 22.04 LTS server for hosting an Immich photo server, including network configuration and necessary port openings.
Server Requirements
To host an Immich photo server, your server must meet the following requirements:
• Operating System: Ubuntu 22.04 LTS (recommended for stability and compatibility)
• CPU: Minimum 2 cores, 4 cores recommended for better performance (e.g., Intel/AMD x86_64 architecture)
• RAM: Minimum 4 GB, 8 GB or more recommended for handling photo processing and multiple users
• Storage: Additional volume for media files and database (SSD recommended for faster access)
• Network: Stable internet connection with at least 10 Mbps upload/download for photo syncing
• Root or sudo privileges for administrative tasks
• Basic knowledge of Linux command-line interface (CLI)
Network Requirements
Immich requires specific ports to be open for web access and internal communication. Ensure the following ports are configured:
• Port 2283 (TCP): Immich web interface (HTTP). Must be open for external access.
• Port 5432 (TCP): PostgreSQL database (used internally, restrict to localhost or Docker network).
• Port 6379 (TCP): Redis (used internally, restrict to localhost or Docker network).
Note: For production environments, consider configuring SSL/TLS (port 443) for secure access. Ensure your cloud provider's security groups or firewall rules allow inbound traffic on port 2283 and, if applicable, port 443.
1. Prepare the System
Update your Ubuntu system and configure necessary cloud provider settings for ports and storage.
• Update the System:
sudo apt update && sudo apt upgrade -y
2. Whitelist Port 2283, 443 & 80 in AWS (Security Group):
• Log in to the AWS Management Console and navigate to EC2 > Security Groups.
• Select the Security Group associated with your EC2 instance.
• Click 'Edit inbound rules' and add a new rule:
• Type: Custom TCP, Port Range: 2283, Source: 0.0.0.0/0 (for public access) or specific IP for restricted access.
• Click 'Save rules'.
Note: Restrict the source to a specific IP range for enhanced security.
3. Whitelist Port 2283, 443 & 80 in Oracle Cloud (Ingress Rule):
• Log in to the Oracle Cloud Console and navigate to Networking > Virtual Cloud Networks.
• Select your VCN, then click 'Security Lists' and choose the default security list.
• Click 'Add Ingress Rules' and configure:
• Source Type: CIDR, Source CIDR: 0.0.0.0/0 (or specific CIDR), Protocol: TCP, Source Port Range: All, Destination Port Range: 2283.
• Click 'Add Ingress Rules'.
Note: Ensure the Source Port Range is set to 'All' to avoid connectivity issues.
4. Attach a New Volume in AWS (EBS Volume):
• In the AWS EC2 Console, navigate to Volumes > Create Volume.
• Set Size: 150 GB, Availability Zone: Same as your EC2 instance, Type: gp3 (or desired type).
• Click 'Create Volume', then select the volume and click 'Actions > Attach Volume'.
• Select your EC2 instance and click 'Attach Volume'.
Note: After attaching, log in to the instance to format and mount the volume (steps omitted as per request).
5. Attach a New Volume in Oracle Cloud (Block Volume):
• In the Oracle Cloud Console, navigate to Storage > Block Volumes.
• Click 'Create Block Volume', set Name: immich-data, Size: 150 GB, Compartment: Your compartment, Availability Domain: Same as your instance.
• Click 'Create Block Volume'.
• Select the volume, click 'Attach to Instance', choose your instance, Attachment Type: iSCSI, and click 'Attach'.
• Copy the iSCSI connection commands provided and run them on your instance to connect the volume.
Note: Use the provided iSCSI commands to connect the volume, then format and mount it (steps omitted as per request).
Important Notes
• Ensure a reliable backup solution is in place for the attached volume.
• For production, configure SSL/TLS to secure the web interface (port 443).
• Regularly monitor server resources (CPU, RAM, disk usage) to ensure smooth operation.
This guide prepares your Ubuntu 22.04 LTS server with the necessary requirements and configuration to host an Immich photo server. Proceed with the Immich installation steps as per the official documentation.
Official Immich Documentation