Overview
This AMI runs a self-hosted federated social server, built on open-source server software at version 4.7.5, on Ubuntu 24.04 LTS. It lets you run your own social media server that federates with others on the same open protocol: posts, follows and replies, a web client, and a REST API for other apps. The vendor images (web, realtime streaming, background worker, Postgres and Valkey) are pinned and baked into the AMI, so first start does not depend on a registry.
What Perimattic adds
The administrator account is created through the vendor's own command-line tool, with a freshly generated password, before this domain is ever published; there is no default account. Public sign-up is closed from first boot (you open it yourself once logged in, if you want other people to register). Every secret the application needs, including its database password and internal encryption keys, is generated on your server using the vendor's own generator commands, never hand-rolled or shipped with a value. Setup checks that self-registration is refused, that a wrong password is refused, that the generated administrator credential works, and that the admin API refuses an anonymous request, before the site is published.
Pinned and patched: the application version is fixed, not latest, and Ubuntu 24.04 LTS is built through an automated EC2 Image Builder pipeline with security updates applied at build time.
Limits you should know
The domain you choose at setup identifies this server to the rest of the federated network and cannot be changed afterward without breaking every account on it; choose it carefully before relying on this instance. Outbound email for notifications needs your own SMTP server, which is not configured by default. Media storage uses the local disk by default, not S3; you can switch to your own S3-compatible bucket by setting a few values in /opt/app/.env.
Licence and attribution
Built on the open-source Mastodon software, version 4.7.5 (AGPL-3.0 licence). Not affiliated with, endorsed by, or sponsored by Mastodon GmbH; Mastodon is a trademark of its owner. This product uses its own generic branding rather than the Mastodon name.
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 administrator password printed at the end of setup Open sign-up for other users from Administration > Server Settings once logged in, if you want it
A domain name with an A record pointing at the instance is required, because the site is served over HTTPS, and this domain cannot be changed later.
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
- Federated social server software, version 4.7.5 (AGPL-3.0), pinned and pre-installed: web client, realtime streaming, background jobs, Postgres and Valkey.
- Secure first login: the administrator account is created through the vendor's own CLI with a generated password, public sign-up is closed by default, and every secret is generated with the vendor's own generator commands. 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: Fediverse Server 4.7.5 (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 account is created through the vendor's own CLI with a generated password before the site is published, public sign-up is closed by default, and every secret is generated with the vendor's own generator commands; setup verifies self-registration and a wrong password are both refused.
- Built on federated social server software (AGPL-3.0, unmodified vendor images); the domain chosen at setup cannot be changed afterward without breaking federation and every account.
- Media storage uses the local disk by default, not S3; outbound email needs your own SMTP server, set in /opt/app/.env.
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 the recommended size: the five containers used about 1 GB combined at idle in our tests, and the web and background-job processes grow under real load. t3.medium is workable for a small single-admin instance.
-
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 Fediverse Server
-
Point a domain at the instance
Create a DNS A record (for example social.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 the database password and every application secret using the vendor's own generator commands
- Creates the administrator account through the vendor's own command-line tool and closes public sign-up
- Starts the full stack, then checks that self-registration and a wrong password are refused, that the generated administrator credential works, and that the admin API refuses an anonymous request
- Configures Apache as an HTTPS reverse proxy (with websocket support for realtime streaming) and requests a Let's Encrypt certificate
- Prints the URL and administrator login; 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 Fediverse Server
Open https://<your-domain>/ and sign in with the administrator password printed at the end of setup (view it again with: sudo cat /opt/app/access.txt). Open sign-up for other users from Administration > Server Settings once logged in, if you want other people to register.
-
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
The database is stored in /opt/app/postgres14, the cache in /opt/app/valkey, and local media in /opt/app/public/system; back them up or snapshot the volume before upgrades. Configure SMTP_SERVER and the S3 variables in /opt/app/.env for outbound email and S3-backed storage.
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.