wild-directory/pixelfed/versions/0/README.md

Pixelfed

Pixelfed is a federated, self-hosted photo sharing platform — a privacy-respecting alternative to Instagram, compatible with the ActivityPub protocol.

Dependencies

• PostgreSQL - Database for storing posts and accounts
• Redis - Used for caching and job queuing
• SMTP - For account verification and notifications

Configuration

Key settings in config.yaml:

• domain - Where Pixelfed will be accessible
• storage - Persistent volume size (default: 2Gi)
• db.name - Database name (default: pixelfed)
• smtp - Email settings inherited from your Wild Cloud SMTP service

First-Time Setup

1. Add and deploy the app:

   wild app add pixelfed
   wild app deploy pixelfed
   

2. Create the admin user by running an artisan command in the pod:

   kubectl exec -n pixelfed deploy/pixelfed -- php artisan user:create \
     --name="Admin" \
     --username="admin" \
     --email="your@email.com" \
     --password="yourpassword" \
     --is_admin=1 \
     --confirm_email=1
   

3. Visit the app URL and log in with the credentials you just created.

Notes

• This package uses the ghcr.io/mattlqx/docker-pixelfed community image (port 80, nginx) since the official image requires authentication to pull
• Federation with Mastodon and other ActivityPub platforms is enabled by default
• User registration can be set to open, invite-only, or closed via Admin → Settings