# 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:
   ```bash
   wild app add pixelfed
   wild app deploy pixelfed
   ```

2. Create the admin user by running an artisan command in the pod:
   ```bash
   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**