MinCloud ☁️ is a file sharing web application build with Flask for small groups and users, which prefer simplicity over extensive features.

Run:

docker run -d -p 80:80 \
    -v /YOURLOCALPATH:/opt/mincloud \
    -e ADMIN_MAIL="myadminmail" \
    -e ADMIN_PASSWORD="myadminpasword" \
    -e ADMIN_USER="myadminuser" --name mincloud number13/mincloud`

Create a Virtualenv:

virtualenv mincloud
virtualenv -p /usr/bin/python3.4 mincloud
source mincloud/bin/activate
pip3 install -r requirements.txt

to leave virtualenv: deactivate

To run the App just do:

python3 db_create.py
python3 db_create_admin.py

python3 wsgi.py

To test it with gunicorn:

python3 db_create.py
python3 admin_user.py
pip3 install gunicorn
gunicorn --bind 127.0.0.1:8000 --workers=12 wsgi:myapp

Be sure to setup SSL-Encrytption!

Change SECRET_KEY in config.py use a random for example:

import os
os.urandom(24).encode('hex')

Edit the admin and adminpassword in db_create_admin.py to your preference.

If you run the app in a Docker, change the gunicorn command in the run.sh to your needs.

Be sure to have access rights to: /opt/mincloud/uploads or change this Directory

If not already installed, install nginx: sudo apt-get update && apt-get install nginx

Create a Virtual-Hosts-File in your /etc/nginx/sites-available folder. For example name it YOURDOMAIN.NAME

server {
    listen 80;
    client_max_body_size 4G;

    #set the correct for your site
    server_name YOURDOMAIN.NAME;

    keepalive_timeout 5;

    location / {
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header Host $http_host;
      proxy_redirect off;
      proxy_pass http://127.0.0.1:8000;
    }

}

Make it available: sudo ln -s /etc/nginx/sites-available/YOURDOMAIN.NAME /etc/nginx/sites-enabled/

Reload Nginx: sudo service nginx reload

Server Side:

• Flask

Client Side:

• Bootstrap
• jQuery
• jQuery-File-Upload
• Fontawesome

• Johannes Kuehnel
• Joerg Hetzner

I try to use SemVer as far as possible in my projects.

This project is licensed under the MIT License - see LICENSE.md for details.

• Thanks to Miguel for his awesome introduction to the Flask Microframework.