Overview
This AMI runs Immich, a self-hosted photo and video library, on Ubuntu 24.04 LTS. Upload photos and video from the web app or the mobile apps, browse them on a map and timeline, and let the built-in machine-learning worker handle face recognition and smart search. Library metadata is stored in PostgreSQL; the machine-learning worker and a Valkey cache run alongside the server. The container images are pinned to version 3.4.0 and baked into the AMI, so first start does not depend on a registry.
What Perimattic adds
The one administrator account is claimed for you during first-login setup, before the site is published, through the application's own first-run API; after that call succeeds a second attempt to claim an account is permanently refused by the application itself, so nobody else can become an admin. Setup proves the generated password works, a wrong password is refused, and anonymous API calls are refused, then Apache publishes the site with a free Let's Encrypt certificate.
Limits you should know
Immich's server and machine-learning worker used roughly 1.5 to 2 GB of memory together in our tests at idle, on top of Postgres and Valkey; a larger instance than the AWS Marketplace default is recommended, see below. All uploaded photos and video are stored on the instance's own root volume with no external object storage; size and back up the volume for your library. Mobile app background upload and sharing between multiple users work as in any Immich install; no user accounts beyond the one administrator are pre-configured.
Licence and attribution
Built on the open-source Immich (AGPL-3.0 licence), unmodified. Not affiliated with, endorsed by, or sponsored by the Immich project; Immich is a trademark of its respective owner.
Getting Started Launch the AMI and open ports 22, 80 and 443 in the security group SSH in and answer the setup prompts (domain and admin email) Open https://your-domain/ and sign in with the admin email and password printed at the end of setup Install the Immich mobile app and point it at https://your-domain/ to back up photos from your phone
A domain name with an A record pointing at the instance is required, because the site is served over HTTPS.
This AMI is built and supported by Perimattic.
Book a free setup consultation at https://cal.com/gaurav-pareek-perimattic/marketplace-setup-consultations or email us at aws-support@perimattic.com .
Support Managed and supported by Perimattic, a cloud infrastructure company with 13+ years of experience serving global clients. We offer free setup assistance, custom integrations, infrastructure consulting, and 24/7 support.
Highlights
- Immich 3.4.0 (AGPL-3.0) pinned and pre-installed: a self-hosted photo and video library with a Postgres backend and a machine-learning worker for face recognition and smart search.
- Secure first login: the one administrator account is claimed through the application's own first-run API before the site is published; a second claim attempt is permanently refused by the application, and anonymous API access and wrong passwords are refused. HTTPS through Apache and Let's Encrypt.
- Built on patched Ubuntu 24.04 LTS and supported by Perimattic: free setup assistance at aws-support@perimattic.com.
Details
Features and programs
Financing for AWS Marketplace purchases
Pricing
- ...
Dimension | Cost/hour |
|---|---|
t3.medium Recommended | $0.03 |
t3.micro | $0.03 |
c3.2xlarge | $0.03 |
c3.4xlarge | $0.03 |
c3.8xlarge | $0.03 |
c3.large | $0.03 |
c3.xlarge | $0.03 |
c4.2xlarge | $0.03 |
c4.4xlarge | $0.03 |
c4.8xlarge | $0.03 |
Vendor refund policy
For any questions or concerns, please contact: Perimattic.com Email: aws-support@perimattic.com
How can we make this page better?
Legal
Vendor terms and conditions
Content disclaimer
Delivery details
64-bit (x86) Amazon Machine Image (AMI)
Amazon Machine Image (AMI)
An AMI is a virtual image that provides the information required to launch an instance. Amazon EC2 (Elastic Compute Cloud) instances are virtual servers on which you can run your applications and workloads, offering varying combinations of CPU, memory, storage, and networking resources. You can launch as many instances from as many different AMIs as you need.
Version release notes
Initial release.
- Application: Immich 3.4.0 (container image pinned, baked into the AMI).
- Base: Ubuntu 24.04 LTS, fully patched at build time, built by an automated EC2 Image Builder pipeline.
- TLS: Apache reverse proxy with a Let's Encrypt certificate requested by certbot at first login.
- Credentials are generated on the instance at first login; none are present in the image.
- Immich has no public self-registration endpoint: the one admin account is claimed through the application's own first-run API during first-login setup, before the site is published; a second claim attempt is permanently refused by the application itself, and setup verifies the generated password works and that a wrong password and anonymous API calls are refused.
- Immich 3.4.0 (AGPL-3.0, unmodified vendor image): server, Postgres, Valkey and a machine-learning worker, all on the loopback interface behind Apache.
- The server and machine-learning worker together used roughly 1.5 to 2 GB of memory in testing; a t3.large or larger instance is recommended.
Additional details
Usage instructions
-
Launch an Instance
From AWS Marketplace, click Continue to Subscribe and then Continue to Configuration to launch the AMI.
-
Choose the Recommended Instance Type
t3.large (8 GB of memory) is recommended: the server and machine-learning worker together used roughly 1.5 to 2 GB at idle in our tests, on top of Postgres, Valkey and Apache, and this leaves headroom for upload and ML processing load; t3.medium (4 GB) was the smallest size we tested and left well under 1 GB free at idle.
-
Configure Security Group
Allow inbound traffic on the following ports:
- 22 (SSH) - terminal access for setup
- 80 (HTTP) - needed to validate your domain for the TLS certificate
- 443 (HTTPS) - access to Immich
-
Point a domain at the instance
Create a DNS A record (for example photos.example.com) pointing to the instance's public IP before you log in.
-
Connect to the Instance
ssh -i <your-key.pem> ubuntu@<public-ip>
-
First-Login Setup
The first SSH login runs a guided setup:
- Prompts for your domain and admin email and checks the DNS A record
- Generates a random 24-character admin password and a random database password on your server
- Starts PostgreSQL, Valkey, the machine-learning worker and the server, then claims the one admin account through the application's own first-run API
- Proves a second admin-claim attempt is refused, the generated password works, a wrong password is refused, and anonymous API calls are refused
- Configures Apache as an HTTPS reverse proxy (with websocket support) and requests a Let's Encrypt certificate
- Prints the URL, admin email and password; they are also stored in /opt/app/access.txt (root only)
If a step fails, fix the problem shown and log in again: the setup resumes where it stopped.
-
Access Immich
Open https://<your-domain>/ and sign in with the admin email and password printed at the end of setup (view them again with: sudo cat /opt/app/access.txt). Install the Immich mobile app and point it at https://<your-domain>/ to back up photos and video from your phone.
-
Credentials
Generated on your server, never shared between customers. View them again with:
sudo cat /opt/app/access.txt
-
Manage the Services
cd /opt/app sudo docker compose ps sudo docker compose restart
Library metadata is in PostgreSQL under /opt/app/postgres; uploaded photos and video are under /opt/app/library, both on the root volume with no size limit; watch disk usage as your library grows. Back up or snapshot /opt/app (stop the stack first for a consistent copy).
Thank you for subscribing.
Need Support or Customization? Perimattic's team can help with setup issues, custom features and integrations:
Email us: aws-support@perimattic.com WhatsApp: +91-92142 66896 Learn more: <www.perimattic.com >
We offer free setup assistance, custom development and integrations, and infrastructure consulting.
Resources
Vendor resources
Support
Vendor support
Support by Perimattic
Perimattic provides 24/7 support for all AWS Marketplace products. Our team has 13+ years of cloud infrastructure expertise serving global clients.
Contact Channels: Email: aws-support@perimattic.com WhatsApp: +91-92142 66896 Website: <www.perimattic.com >
What We Help With: Initial setup and configuration assistance (free) Troubleshooting connectivity, performance, and backup issues Custom development and integrations Infrastructure consulting and architecture review Migration planning from other solutions Automation solutions and scaling guidance
Instance Sizing Guidance: t2.medium or t3.medium: Development environments, small applications m5.large: Production workloads with moderate traffic m5.xlarge: High-traffic production deployments and larger datasets
For workload-specific sizing recommendations, contact our team for a free consultation.
Refunds and Issues: If you experience any issues or need to request a refund, contact us at aws-support@perimattic.com and we will respond promptly.
AWS infrastructure support
AWS Support is a one-on-one, fast-response support channel that is staffed 24x7x365 with experienced and technical support engineers. The service helps customers of all sizes and technical abilities to successfully utilize the products and features provided by Amazon Web Services.