Overview
This AMI runs a self-hosted chat server built on the open Matrix protocol, version 1.164.2, on Ubuntu 24.04 LTS. Your team signs in with any Matrix-compatible chat app (Element and others) for real-time messaging, direct messages and group rooms. The vendor image is pinned to this exact version and baked into the AMI, so first start does not depend on a registry. Messages, media and the database are kept on the instance.
What Perimattic adds
The administrator is created for you with the server's own command-line tool and a generated 24-character password, before the site is published, so nobody else can claim it. Self-service account creation is off by default; guest access is off too. Setup checks that the password works, that a wrong or blank password is refused, and that a stranger's registration attempt is refused, before Apache publishes the site.
Federation is OFF by default: this server does not exchange messages with other Matrix servers, and the federation and key-discovery endpoints are blocked both in the server's own settings and at Apache, in depth. HTTPS and the real-time connection work through an Apache reverse proxy with a free Let's Encrypt certificate from certbot.
Limits you should know
The server name is set from your domain at first login and cannot be changed afterwards: Matrix bakes it permanently into every account and room on the server, so choose your domain carefully before setup. No SMTP server is configured; this only affects optional email-based password recovery. In our tests the application and database together used well under 400 MB of memory; a t3.small is a comfortable size for a small team.
Licence and attribution
Built on the open-source Matrix Synapse homeserver (AGPL-3.0 licence), unmodified. Not affiliated with, endorsed by, or sponsored by the Matrix.org Foundation or Element; Matrix and Synapse are trademarks of their respective owners.
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) - the domain becomes the permanent server name Sign in with Element or another Matrix client at your domain, using the administrator username and the password printed at the end of setup Invite your team and start chatting
A domain name with an A record pointing at the instance is required, because the site is served over HTTPS and the domain becomes the permanent server name.
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
- Version 1.164.2 (AGPL-3.0) pinned and pre-installed: private real-time team chat on the open Matrix protocol, with PostgreSQL storage.
- Secure first login: the administrator is created with the server's own command-line tool and a generated 24-character password before the site is published; self-service registration and guest access are off, and federation is off by default and blocked at Apache too. 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.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: Team Chat Server 1.164.2 (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 administrator password is generated at first login and the account is created with the server's own command-line tool before the site is published; self-service registration and guest access are off, and setup verifies every refusal before publishing.
- Matrix Synapse 1.164.2 (AGPL-3.0, unmodified vendor image) runs with PostgreSQL; federation is off by default and blocked at Apache as well as in the server's own configuration.
- No SMTP server is configured out of the box; the server name is permanent once set.
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 a comfortable size for a small team: the application and database together used well under 400 MB in our tests. Choose a larger type for many concurrent users.
-
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 Team Chat Server
-
Point a domain at the instance
Create a DNS A record (for example chat.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 (the domain becomes the permanent server name)
- Generates the server configuration, switches it to PostgreSQL, and turns off self-service registration, guest access and federation
- Generates a random 24-character administrator password and creates the administrator with the server's own command-line tool
- Starts the server, then checks that the password works, that a wrong or blank password is refused, and that a stranger's registration is refused
- Configures Apache as an HTTPS reverse proxy with real-time connection support 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 Team Chat Server
Sign in with Element (or another Matrix-compatible client) at https://<your-domain>/ using the administrator username and the password printed at the end of setup (view it again with: sudo cat /opt/app/access.txt). Invite your team from within the client once signed in.
-
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
Messages, media, the configuration and the signing key are kept in /opt/app/data, and the database in /opt/app/postgres; back them up or snapshot the volume before upgrades. The server name cannot be changed after setup.
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.