elestio/pixelfed repository overview

⁠

⁠Pixelfed, verified and packaged by Elestio

Pixelfed⁠ is an open source, decentralized alternative to Instagram that recently added a tool for importing all your Instagram photos. This means you can automatically give all of the photos and videos you uploaded to Instagram a new home.

Deploy a fully managed Pixelfed⁠ on elest.io⁠ if you want automated backups, reverse proxy with SSL termination, firewall, automated OS & Software updates, and a team of Linux experts and open source enthusiasts to ensure your services are always safe, and functional.

⁠Why use Elestio images?

• Elestio stays in sync with updates from the original source and quickly releases new versions of this image through our automated processes.
• Elestio images provide timely access to the most recent bug fixes and features.
• Our team performs quality control checks to ensure the products we release meet our high standards.

⁠Usage

⁠Git clone

You can deploy it easily with the following command:

git clone https://github.com/elestio-examples/pixelfed.git

Copy the .env file from tests folder to the project directory

cp ./tests/.env ./.env

Edit the .env file with your own values.

Run the project with the following command

./scripts/presInstall.sh
docker-compose up -d
./scripts/postInstall.sh

You can access the Web UI at: http://your-domain:8686

⁠Docker-compose

Here are some example snippets to help you get started creating a container.

version: "3.3"

services:
  app:
  image: elestio/pixelfed:latest
  restart: always
  env_file:
    - ./.env
  volumes:
    - ./app-storage:/var/www/storage - "./.env:/var/www/.env"
  ports:
    - "172.17.0.1:8686:80"
  depends_on:
    - db
    - redis

  worker:
    image: elestio/pixelfed:latest
    restart: always
    env_file:
      - ./.env
    volumes:
      - ./app-storage:/var/www/storage
      - "./.env:/var/www/.env"
    command: gosu www-data php artisan horizon
    depends_on:
      - db
      - redis

  db:
    image: mariadb:jammy
    restart: always
    command: --default-authentication-plugin=mysql_native_password
    env_file:
      - ./.env
    volumes:
      - "./db-data:/var/lib/mysql"
    ports:
      - 172.17.0.1:4406:3306

  redis:
    image: elestio/redis:7.0
    restart: always
    env_file:
      - ./.env
    volumes:
      - "./redis-data:/data"
    command: ["redis-server", "--requirepass", "${REDIS_PASSWORD}"]

⁠Environment variables

⁠Maintenance

⁠Logging

The Elestio Pixelfed Docker image sends the container logs to stdout. To view the logs, you can use the following command:

docker-compose logs -f

To stop the stack you can use the following command:

docker-compose down

⁠Backup and Restore with Docker Compose

To make backup and restore operations easier, we are using folder volume mounts. You can simply stop your stack with docker-compose down, then backup all the files and subfolders in the folder near the docker-compose.yml file.

Creating a ZIP Archive For example, if you want to create a ZIP archive, navigate to the folder where you have your docker-compose.yml file and use this command:

zip -r myarchive.zip .

Restoring from ZIP Archive To restore from a ZIP archive, unzip the archive into the original folder using the following command:

unzip myarchive.zip -d /path/to/original/folder

Starting Your Stack Once your backup is complete, you can start your stack again with the following command:

docker-compose up -d

That's it! With these simple steps, you can easily backup and restore your data volumes using Docker Compose.

⁠Links

• Pixelfed documentation⁠

• Pixelfed Github repository⁠

• Elestio/Pixelfed Github repository⁠