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.