Pixelfed is a decentralized photo-sharing platform built on the ActivityPub protocol, allowing users to share images across a network of independent servers in the Fediverse. It’s designed for photographers, artists, and privacy-conscious users who want to avoid centralized platforms like Instagram. Pixelfed eliminates algorithmic feeds and ads, putting control back in the hands of users and communities.
Built with Laravel and PHP, Pixelfed integrates with the broader Fediverse via ActivityPub, enabling seamless interaction with Mastodon, PeerTube, and other federated services. It supports self-hosting, Docker deployment, and YunoHost installation, making it accessible for individuals and organizations seeking full data ownership and interoperability.
What You Get
- ActivityPub Federation - Seamlessly share photos with Mastodon, Pleroma, and other Fediverse platforms using the ActivityPub protocol.
- Self-hostable Photo Platform - Deploy on your own server using Laravel, PHP, and MySQL/PostgreSQL for full data control.
- No Algorithmic Feeds - Posts appear in chronological order with no engagement-based manipulation or hidden content.
- Image Privacy Controls - Set posts to public, unlisted, followers-only, or private with granular audience targeting.
- Multi-Server Support - Interact with users on other Pixelfed instances and Fediverse platforms without siloed accounts.
- Built-in Media Gallery - Organize and display photos in a clean, responsive visual timeline with lightbox and zoom support.
Common Use Cases
- Running a photography portfolio site - A photographer hosts their work on a private Pixelfed instance to showcase images without ads or data harvesting.
- Joining a community of visual artists - An illustrator follows and shares work with other Fediverse users across Mastodon and Pixelfed instances.
- Replacing Instagram with a privacy-focused alternative - A user migrates their photo library to Pixelfed to avoid surveillance capitalism and algorithmic manipulation.
- Running a nonprofit visual archive - A cultural organization deploys Pixelfed to publicly share historical photos with global, federated access.
Under The Hood
Architecture
- Laravel-based monolithic architecture with clear separation of concerns using MVC patterns, where controllers delegate business logic to dedicated service classes to ensure testability and reduce duplication.
- ActivityPub federation is implemented through decoupled service layers and asynchronous job pipelines that handle distributed operations reliably via Laravel Queues, ensuring protocol compliance and scalability.
- Domain-specific concerns like media handling, spam detection, and authentication are modularized into isolated services and event-driven observers, decoupling side effects from core model logic.
- Dependency injection is consistently applied through constructor-based injection, promoting inversion of control and enhancing testability without reliance on facades.
- The architecture leverages mature tools like Fractal, Horizon, and custom pipelines to build a production-grade, extensible decentralized platform.
Tech Stack
- PHP 8.3/8.4 backend powered by Laravel 12, with integrated OAuth2, real-time queue monitoring, and system-wide observability.
- MySQL database paired with Redis for caching and pub/sub messaging, all containerized with Docker using health checks and persistent storage.
- Frontend built with Vue 2, Laravel Mix, and Webpack, enhanced with Bootstrap 4, jQuery, and rich UI libraries for a polished user experience.
- Asset pipeline optimized with Sass, Vue-loader, and esbuild for efficient production builds.
- ActivityPub federation implemented via custom Laravel packages and Guzzle for distributed social interactions.
- Deployment orchestrated through Docker Compose with isolated containers for application, workers, and scheduler, using a custom PHP-FPM/Nginx base image.
Code Quality
- Extensive test coverage for core protocols including ActivityPub validation, audience parsing, and cryptographic operations, using structured test data to verify compliance.
- Strong type safety and schema validation enforced through dedicated validator classes that ensure federated data integrity.
- Clear separation of concerns with service-oriented design, where controllers remain thin and logic is encapsulated in domain-specific services.
- Robust error handling prioritizes validation assertions over exceptions, aligning with protocol-level expectations but limiting detailed debugging context.
- Consistent naming and modular test organization reflect a disciplined codebase aligned with domain boundaries.
What Makes It Unique
- Native ActivityPub implementation with deep federation support enables seamless cross-platform interaction without external dependencies.
- Built-in automated spam detection with adaptive classification and admin training workflows that evolve with community-specific abuse patterns.
- Unified moderation pipeline that correlates user reports, automated flags, and admin actions into a single metadata-rich audit trail.
- Customizable UI theming and CSS injection allow instance administrators to fully rebrand the frontend without touching core templates.
- Instagram data import tool that reconstructs posts with visual context and metadata—a rare capability in decentralized social platforms.
- ModLog service with fanout notifications creates a transparent, real-time governance layer for moderators across the instance.