Pixelfed helm chart

A helm chart to setup Pixelfed, a federated social media app focused on photos.

This chart is still in a testing phase and may not be fully stable yet.

Uses @mattlqx's docker image which is for now pinned to a specific nightly build of the upstream dev branch of the official pixelfed repo. You may want to set image.tag="dev-nginx" (built from the top of the pixelfed repo's dev branch nightly, so it always has the latest version of pixelfed - but maybe buggy) as it may solve issues you are having that are already fixed such as this bug that was already patched.

Features

• includes bitnami subcharts for valkey (redis) and postgresql (database)
  • but you can also bring your own valkey, redis, or postgresql database
  • we're also looking for anyone who wants to test the mariadb subchart
• helm parameter (values.yaml) docs autogenerated via helm-docs in README.md
• use existing Secrets for valkey, postgresql, and mail (smtp)
• RenovateBot keeps the subcharts and docker image up to date
• configurable liveness and readiness probes (or none at all)
• configure tolerations, affinity, nodeselectors
• configure persistence with a PVC we create, or bring your own
• use extra volumes, volumemounts, containers, initContainers

TLDR

# add the chart repo to your helm repos
helm repo add pixelfed https://small-hack.github.io/pixelfed-chart

# download the values.yaml and edit it with your own values such as YOUR hostname
# especially important is pixelfed.app.domain
helm show values pixelfed/pixelfed > values.yaml

# install the chart
helm install --namespace pixelfed --create-namespace pixelfed/pixelfed --values values.yaml

Notes

You can find some of the general Pixelfed configuration docs here:

https://docs.pixelfed.org/running-pixelfed/installation.html

But you'll find additional configuration here:

https://github.com/pixelfed/pixelfed/blob/dev/.env.docker

Creating your first user

$ kubectl exec -it YOUR_PIXELFED_POD -- /bin/bash -c "php artisan user:create --name=myname --username=myusername [email protected] --password=password --is_admin=false --confirm_email=true"

Contibuting

Bugs and other Issues

If you have a bug to report or a feature to request, you can first search the GitHub Issues, and if you can't find what you're looking for, feel free to open an Issue.

Contributing to the Code

We're always happy to review a pull request :) Please check out the contributing doc.