Overview
This AMI runs Pixelfed, an open-source, federated photo and video sharing platform built on the ActivityPub protocol, on Ubuntu 24.04 LTS. Your instance federates with other Pixelfed, Mastodon and compatible servers so people elsewhere can follow accounts here and see posts in their own timeline, while your community's data stays on your own server. The application image is release 0.15.2, built from the project's own Dockerfile (ffmpeg and libvips compiled in) and pinned into the AMI, so first start does not depend on a registry.
What Perimattic adds
Your administrator account is created for you during setup, through Pixelfed's own command-line tool, before the site is published; public sign-up is closed from the first boot. Apache provides HTTPS with a free Let's Encrypt certificate, and the Passport keys that the REST API and federation protocol need are generated on your server at first login, not shipped in the image.
Limits you should know
Sending email (digests, password resets, remote-follow confirmations) needs an SMTP server you provide; set it in the environment file after launch. Media is stored on the local disk by default; attach S3-compatible storage if you need offloaded storage. The background job queue (Horizon) is the heaviest part of this stack; see the instance size recommendation below.
Licence and attribution
Built on the open-source Pixelfed (AGPL-3.0 licence), unmodified. Not affiliated with, endorsed by, or sponsored by its authors; Pixelfed 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 with the email you gave and the password printed at the end of setup Post your first photo, then check Settings for federation, privacy and media options
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
- Pixelfed 0.15.2 (AGPL-3.0) pinned and pre-installed: federated, ActivityPub photo and video sharing with MariaDB and Valkey.
- Secure first login: the administrator is created for you before launch, public sign-up is closed, a wrong password is refused, and the password is a generated 24-character value. 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: Pixelfed 0.15.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 is created during setup through Pixelfed's own command-line tool (a generated 24-character password); public sign-up is closed from first boot, and setup verifies a wrong password and a stranger's sign-up are both refused before the site is published.
- Pixelfed 0.15.2 (AGPL-3.0, built from the vendor's own Dockerfile, unmodified application code) runs behind Apache with MariaDB and Valkey; the Passport OAuth keys the API and federation protocol need are generated on first boot, not shipped in the image.
- SMTP and S3-compatible media storage are left to the buyer to configure; the background job queue (Horizon) is the heaviest part of the stack, see the instance size recommendation.
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 background job queue (Horizon) alone used about 1.5 GB in our tests even with no real traffic, and the full stack (web app, Horizon, scheduler, MariaDB, Valkey) used about 2.4 GB together. t3.medium (4 GB) passed our tests too but leaves only about 1.3 GB of headroom, which is tight once real media processing and federation traffic start; choose t3.large or larger for any real community.
-
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 Pixelfed
-
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 password and Laravel's application key on your server
- Starts MariaDB and Valkey, starts the app (which applies the database migrations automatically), generates the Passport OAuth keys the API and federation protocol need, creates the administrator account through Pixelfed's own command-line tool, then starts the queue worker and scheduler
- Checks that the password works, that a wrong password and a stranger's sign-up are both refused, and that an unauthenticated API request is refused cleanly rather than with a server error
- Configures Apache as an HTTPS reverse proxy and requests a Let's Encrypt certificate
- Prints the URL, 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 Pixelfed
Open https://<your-domain>/ and sign in with the email you gave and the password printed at the end of setup (view it again with: sudo cat /opt/app/access.txt).
-
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
Account and post data is stored in /opt/app/mysql and uploaded media in /opt/app/storage; back up all of /opt/app or take EBS snapshots before upgrades. The application key and the Passport OAuth keys in .env and /opt/app/storage protect sessions and API tokens: keep them with your backups.
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.