Overview
This AMI runs Homarr, the open-source dashboard, on Ubuntu 24.04 LTS. You build boards of links, widgets and integrations with drag and drop, and manage users and groups with permissions. The upstream vendor image of Homarr 2.11.1 is pinned and baked into the AMI, so first start does not depend on a registry. Data is kept in an SQLite database on the instance.
What Perimattic adds
Onboarding handled for you: a fresh Homarr lets the first visitor run the onboarding and become the administrator. This AMI runs the application's own onboarding through its API during first-login setup, before anything is published, with a random 24-character administrator password generated on your server, and then closes it. There are no default or shared credentials in the image. Apache provides HTTPS with a free Let's Encrypt certificate for your domain.
Limits you should know
The server downloads the public icon catalogue from a content delivery network and GitHub, and your browser loads icons from the same network; no data of yours is sent. Widgets contact the services you add. There is no self-registration: more users join through an invitation link that an administrator creates. The image contains a Redis cache, which runs inside the container and is not reachable from outside. In our tests Homarr used about 320 to 330 MB of memory, so a t3.small (2 GB) is the recommended starting size.
Licence and attribution
Homarr is released under the Apache License 2.0; this AMI runs the unmodified upstream image. The image's built-in cache is Redis 8, which its upstream offers under the RSALv2, SSPLv1 or AGPLv3 licences, unmodified. Built on the open-source Homarr (Apache-2.0). Not affiliated with, endorsed by, or sponsored by Homarr Labs; Homarr is a trademark of its 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 as admin with the password printed at the end of setup Add your apps and integrations to the board
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
- Homarr 2.11.1 (Apache-2.0) pinned and pre-installed: drag-and-drop boards, widgets and integrations with SQLite storage.
- Secure first login: the first-run onboarding is completed and closed for you with a random 24-character administrator password, boards are private, vendor analytics are blocked and the Docker socket is not mounted. 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
Introducing multi-product solutions
You can now purchase comprehensive solutions tailored to use cases and industries.
Features and programs
Financing for AWS Marketplace purchases
Pricing
- ...
Dimension | Cost/hour |
|---|---|
t3.small 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: Homarr Dashboard 2.11.1 (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.
- The first-run onboarding is run and closed during first-login setup with a random 24-character administrator password; setup verifies that the onboarding cannot be claimed again, that wrong and default logins and anonymous requests are refused and that vendor analytics hosts are blocked.
- Application: Homarr 2.11.1 (Apache-2.0, unmodified official image) running as an unprivileged user; the Docker socket is not mounted.
- Analytics are off and the vendor's analytics host names are redirected to the container itself.
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.small (2 GB of memory) is the recommended starting size: Homarr used about 320 to 330 MB in our tests, including its built-in cache.
-
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 Homarr Dashboard
-
Point a domain at the instance
Create a DNS A record (for example home.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 administrator password and a 64-character encryption key on your server
- Starts Homarr and runs its first-run onboarding through the application's API: creates the administrator and finishes the setup with analytics off
- Checks that the onboarding is closed, that the password works, that wrong and default logins and anonymous requests are refused
- Configures Apache as an HTTPS reverse proxy (with WebSocket) and requests a Let's Encrypt certificate
- Prints the URL, username 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 Homarr Dashboard
Open https://<your-domain> and sign in as admin with the password printed at the end of setup (view it again with: sudo cat /opt/app/access.txt). Change the password in your profile whenever you like.
-
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
Data (a SQLite database) is in /opt/app/appdata: back up all of /opt/app or snapshot the volume before upgrades. Keep /opt/app/.env with your backups: its SECRET_ENCRYPTION_KEY decrypts the integration secrets. To reset the administrator password follow the instructions in /opt/app/access.txt.
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.