README.md

expanse

selfhosted multi-user web app for externally storing Reddit items (saved, created, upvoted, downvoted, hidden) to bypass Reddit's 1000-item listing limits

• features::
  • new items auto-sync
  • synced items not affected by Reddit deletion
  • search for items
  • filter by subreddit
  • unsave/delete/unvote/unhide items from Reddit directly on expanse
  • import csv data from Reddit data request
  • export data as json
• demo
• requirements::
  • git
  • docker (managed/rootless)
  • docker compose
• setup::
  1. clone repo: git clone https://github.com/aplotor/expanse.git
  2. cd into repo: cd ./expanse/
  3. create environment variables file: cp ./backend/.env_example ./backend/.env_prod
  4. fill out the values in the ./backend/.env_prod file
• usage::
  1. cd into repo
  2. start: sh ./run.sh prod up (stop: sh ./run.sh prod down)
  3. go to http://localhost:1301 / http://{host ip}:1301
• updating::
  1. cd into repo
  2. update: sh ./run.sh prod update
• (optional) systemd service

  1. cd into repo
  2. update repo path in service file: sed -i "s./opt/expanse.$PWD.g" ./expanse.service
  3. allow executing ./run.sh: chmod +x ./run.sh
  4. enable and start service: systemctl enable ./expanse.service --now