ShareX custom uploader/destination server written in Python (Flask).

I created this mostly for my personal use, but if you have any suggestions, ideas or improvements feel free to open a new issue (pull requests are also welcome).

Below you'll find two examples on how to setup this application.

1. Clone the repository

git clone https://github.com/vremes/shrpy.git

2. Move to cloned repository directory and install requirements

cd shrpy pip3 install -r requirements.txt

3. Setup .env file, see Configuration for additional information

cp .env_template .env nano .env

• You must set FLASK_SECRET to something, good way to generate secrets is the following command

  python -c "from secrets import token_urlsafe; print(token_urlsafe(64))"

4. Run Flask built-in development server

python3 wsgi.py

1. Install NGINX and Supervisor

apt install nginx supervisor

2. Install Gunicorn and Gevent

pip3 install gunicorn gevent

3. Clone the repository to /var/www/

git clone https://github.com/vremes/shrpy.git /var/www/shrpy

4. Move to cloned repository directory and install requirements

cd /var/www/shrpy/ pip3 install -r requirements.txt

5. Setup .env file, see Configuration for additional information

cp .env_template .env nano .env

• You must set FLASK_SECRET to something, good way to generate secrets is the following command

  python -c "from secrets import token_urlsafe; print(token_urlsafe(64))"

6. Configure Supervisor to run Gunicorn, see Gunicorn Documentation for additional information

nano /etc/supervisor/conf.d/shrpy.conf

• Example configuration:

  [program:shrpy] directory=/var/www/shrpy command=gunicorn --bind=127.0.0.1:8000 --worker-class=gevent wsgi:application autostart=true autorestart=true stderr_logfile=/var/log/shrpy.err.log stdout_logfile=/var/log/shrpy.out.log 

7. Update Supervisor configuration and configure NGINX

supervisorctl update nano /etc/nginx/sites-available/shrpy.conf

• Example configuration:

  server { listen 80; server_name example.com; # <==== Change to your domain name client_max_body_size 16M; location / { include proxy_params; proxy_pass http://127.0.0.1:8000; } location /uploads { alias /var/www/shrpy/app/uploads/; } }

8. Enable NGINX configuration and restart NGINX

ln -s /etc/nginx/sites-available/shrpy.conf /etc/nginx/sites-enabled/ service nginx restart

9. Visit the root (/) path on your domain and it should be running:

{ "message": "It works! Beep boop." }

shrpy looks for config values from OS environment variables.

You can set these environment variables in .env_template and then rename the .env_template to .env.