Skip to content.
Joe Heaton's Webzone
🥐 ☕
Online since 2011

Pixelfed - self-hosted & federated photo hosting

In addition to a typical PHP server, you will need to install the php-bcmath package. Install image processing libraries apt install jpegoptim optipng pngquant.

Following PixelFed’s Manual Setup instructions.

git clone https://github.com/pixelfed/pixelfed
cd pixelfed
composer install
chown -c www-data:www-data -R storage/

Set the website domain name for the following variables in .env:

  • APP_URL, with protocol (https://)
  • APP_DOMAIN
  • ADMIN_DOMAIN
  • SESSION_DOMAIN

Using the Laravel “Artisan” console we prepare the app & database.

php artisan key:generate
php artisan migrate
php artisan config:cache
php artisan route:cache
php artisan horizon:install
php artisan storage:link
php artisan optimize

Troubleshooting

Application logs can be found in ./storage/logs/laravel.log, although, unless PHP is crashing you won’t find much in these logs. Luckily you can put the app into debug mode with DEBUG=true in .env.

Once in debug mode any internal errors are explained on in-place of the page you’re trying to load.

My particular issue was caused by me setting MAIL_ENCRYPTION to tls instead of ssl

Settings!