This is a simple file uploader that is configurable and has an admin page.
It's made entirely in python using flask.
Make a virtual env and install requirements.
Read this to see how to configure it.
Run venv/bin/python schema.py to prepare the database.
Run venv/bin/python add_admin.py to add yourself as the first admin.
Run with gunicorn with this systemd service:
[Unit]
Description=Gunicorn instance to serve harambe
After=network.target
[Service]
User=someuser
Group=www-data
WorkingDirectory=/home/someuser/harambe/server
ExecStart=/home/someuser/harambe/server/venv/bin/python -m gunicorn -w 4 "app:app" --bind 0.0.0.0:4040 --timeout 600 --keep-alive 5 --error-logfile /home/me/error_harambe.log
TimeoutStopSec=3
[Install]
WantedBy=multi-user.target
In apache conf:
ProxyPreserveHost On
ProxyPass / http://localhost:4040/ timeout=600 Keepalive=On retry=1 acquire=3000
ProxyPassReverse / http://localhost:4040/
LimitRequestBody 522144000
Configs are set in server/config.toml which you must create.
You can check the default values in config.py and redefine what you need.
The toml format looks as followed:
For example:
files_dir = "/mnt/drive/harambe"
uppercase_ids = falseThe config file is automatically reloaded when the file is modified.
This is done by using the watchdog library.
So there's no need to restart the server on config changes.
There are some exceptions like app_key which can't be changed at runtime.
There are admin pages to view and delete files and users.
Admins can create more users, but you need to create the first admin.
You can do it with venv/bin/python add_admin.py.
Users can be added by admins in the admin page.
username is the main id of the user, it can't change.
password password used to authenticate.
name is the public name to be displayed in posts.
If name is empty, no name will be displayed.
admin defines if a user has admin rights or not.
rpm the amount of requests per minute it can do.
max_size is the max file size permitted to that user.
If max_size is set to 0, it will use the default max file size config.
If reader is true, the user can view the file list page.
If lister is true, the users's post get to be listed.
If reacter is true, the users can react to posts.
mark is a string that is appended to urls on uploads from that user.
For example: site.com/01jkxsxp4k_wlk instead of site.com/01jkxsxp4k.
It could be useful to keep track of who uploaded who based on urls and file names.
If empty, it won't use a mark.
Links can be shown in the main page if you create them in the config:
[[links]]
name = "About"
url = "/page/about"
[[links]]
name = "Recipes"
url = "/page/recipes"
target = "_blank"target is optional. _blank means to open them in a new tab.
There is a directory called assets inside static.
This directoy is not version controlled so you can add anything you want.
You can use this to host html pages which you can link in the main page.
Just make sure to not delete the .gitignore file that is inside.
There is an sqlite3 database that holds some data about the files.
This includes the creation date, the title, and views.
This is located in server/database.sqlite3.
To create and update the database run schema.py.
There is this script which you can use to upload if you are a user.
Just change URL, USERNAME, and PASSWORD, and you might also need to change ENDPOINT.
The arguments are a file path, and an optional mode argument which you can set to title.
If you set that second argument to title it will use zenity to prompt for a title.