(fork of sr.ht)

Private file hosting with python/nginx

Differences from upstream

• Fixed a few instances where page redirects would take you to the local IP of the sr.ht instance, which obviously isn't connectable from outside.
• Removed most hardcoded branding and moved it to config strings.
• Switched to simplex bootstrap theme
• Some minor style fixes
• Improvements to administration with some cli scripting
• Removed the anime branding and replaced with a more sfw icon
• Being able to delete files from the web interface

Running the site

Quick overview: Clone the repository

Find a place you want the code to live.

$ git clone git://github.com/optimumtact/sr.ht.git
$ cd sr.ht

Deployment

This has a working docker-compose file, just install docker and docker-compose

Then copy the example env file and adjust for your needs

cp env.dev.example .env
nano .env

Soft link the production docker-compose to docker-compose.yml ln -s docker-compose-prod.yml docker-compose.yml

Then start the project with compose docker-compose up -d

then you can browse to localhost:5000 (by default) to access it

Dev deployment

This has a working docker-compose file for the database, so you can install docker + docker-compose + poetry + dotenv

Then copy the example env file and adjust for your needs cp env.dev.example .env nano .env

Soft link the dev docker-compose to docker-compose.yml ln -s docker-compose-dev.yml docker-compose.yml

Then start the project with compose docker-compose up -d

Then run the flask developer app, with dotenv and poetry to manage the requirements dotenv run poetry run python debug.py

If it fails to start the first time, just run it again, the db might not have stood all the way up before the web container started

** About the production deployment ** The Docker uses python:3-slim and hivemind for process management, so it obeys the procfile standard, both gunicorn and nginx run in a single container, as the application was originally intended for a nginx + wsgi hosting and needs to share a storage folder

https://github.com/DarthSim/hivemind

Becoming an admin and bootstrapping initial user

You can become an admin with the management cli script

docker-compose exec -it web bin/bash
cd /app
python manage.py user create {yourusername} {password} {emailaddress}
python manage.py admin promote {youruser}

Customization

You can customize the appearance of the site with template overrides. Create a directory called overrides and copy templates from the templates directory into overrides. Modify them as you see fit, they will be used instead of the version from templates.

Although I don't know why you would do this when you can just modify source