Skip to content

Pixelfed App

About

A free and ethical photo sharing platform, powered by ActivityPub federation.

Admin

To make a register user an admin, use the Web terminal and run the following command:

# sudo -E -u www-data php artisan user:admin username_here

Found username: girish

 Add admin privileges to this user? (yes/no) [no]:
 > yes

Successfully changed permissions!

Further administration commands like removing a user, removing unused media can be found in Pixelfed docs.

The admin page is located at https://pixelfed.example.com/i/admin/dashboard.

Federation

To test if federation works, search for a handle like @girish@pixelfed.social or @social@pixelfed.cloudron.io. You should then be able to follow that handle. Note that you can only see posts that are made after you followed the handle. Existing posts will not appear in you stream.

If following doesn't work:

  • Login as an admin user on your Pixelfed instance
  • Check https://pixelfed.domain.com/horizon/failed for job failures

Customizations

Customizations can be made by editing in one of the following ways:

  • In the Admin page. In Pixelfed, Go back to previous design and then select Admin from the navigation bar. Note that when making changes in the Admin Panel, the app has to be restarted and caches still have to be cleared.
  • Editing /app/data/env.production using the File manager. See the Pixelfed docs on the various config options.

Note that any value in the settings UI seems to supersede the value in the env file. The exact ordering and priority of configuration settings is unclear.

Don`t forget to restart the app after making any changes.

Disable Registration

Registration can be disabled in the Admin page (see above).

Clear Cache

When making changes via the admin panel, often the cache has to be cleared in addition to an app restart. To clear the cache, open a Web Terminal and run the following commands:

# sudo -E -u www-data php artisan cache:clear
# sudo -E -u www-data php artisan optimize:clear
# sudo -E -u www-data php artisan optimize