Overview
This AMI runs a lightweight chat client (version v1.12.34) that connects to your own Matrix-compatible homeserver, such as Perimattic's own Team Chat Server listing or any other homeserver you control, on Ubuntu 24.04 LTS. No homeserver, accounts or chat data are bundled with this AMI; the server only serves the static client files over HTTPS. The container image is pinned and baked into the AMI, so first start does not depend on a registry.
What Perimattic adds
During first-login setup you are asked for your homeserver URL, which is validated by calling its own /_matrix/client/versions endpoint before anything is published; the site only goes live once that check passes. The homeserver address is then baked into the client configuration with custom-homeserver entry disabled in the UI, so a visitor cannot repoint the page at a different server. Apache provides HTTPS with a free Let's Encrypt certificate, and the client container runs read-only with its capabilities dropped to the minimum needed.
Limits you should know
The client itself is very light, using about 10 MB of memory at idle in our tests, so t3.small (2 GB) is more than enough. Since no homeserver is bundled, your sign-in, your contacts and all of your messages depend entirely on the homeserver you point this at; back up and secure that homeserver separately. A domain name with a DNS A record is required because the site is served over HTTPS.
Licence and attribution
This client is multi-licensed by its publisher; this AMI uses it under the AGPL-3.0 option, unmodified. Not affiliated with, endorsed by, or sponsored by its publisher; the client name 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, admin email, and your homeserver URL) Open https://your-domain/ and sign in with an account on your homeserver Invite others to chat once you are signed in
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
- Lightweight chat client v1.12.34, pinned and pre-installed: connects to any Matrix-compatible homeserver you control, such as Perimattic's own Team Chat Server listing.
- Secure first login: your homeserver URL is validated against its own API before the site goes live, then locked in so visitors cannot repoint the client. 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: Team Chat Client v1.12.34 (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.
- No account is created on this instance: the client connects to a homeserver you choose, validated against its own API during first-login setup before the site is published, then locked so visitors cannot repoint it elsewhere.
- Chat client v1.12.34 (multi-licensed, used here under AGPL-3.0, unmodified) runs read-only with its capabilities dropped to the minimum needed, on the loopback interface behind Apache.
- No Matrix homeserver is bundled; pairs with Perimattic's own Team Chat Server (Synapse) listing or any other Matrix-compatible homeserver.
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 more than enough: the client itself used about 10 MB in our tests.
-
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 Client
-
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
- Asks for your homeserver URL and validates it by calling its own /_matrix/client/versions endpoint
- Bakes the validated homeserver address into the client configuration with the custom-homeserver UI entry disabled
- Configures Apache as an HTTPS reverse proxy and requests a Let's Encrypt certificate
- Prints the URL and the homeserver you configured; 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 Client
Open https://<your-domain>/ and sign in with an account that already exists on the homeserver you configured during setup (view it again with: sudo cat /opt/app/access.txt). Invite others to chat once you are signed in; account creation and all messages are handled by your homeserver, not this AMI.
-
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
No chat data is stored on this instance; it only serves the static client files. Back up and secure your Matrix homeserver separately, since all accounts and messages live there.
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.