An example Flask app that uses s3-saver, url-for-s3, flask-thumbnails-s3, and flask-admin-s3-upload to store and retrieve files on Amazon S3.

This app lets you upload, re-upload, and delete a single image. By changing a few lines of config, the image will be stored either locally, or in a S3 bucket of your choice.

1. Make sure you have installed:
   • SQLite (3.8+ recommended)
   • Python 2.7+ (and virtualenv)
   • Pillow (Python image library)

2. Clone the flask-s3-save-example repo: :

   git clone git@github.com:Jaza/flask-s3-save-example.git
   cd flask-s3-save-example

3. Set up a (Python 2.7) virtualenv (recommended to use with --system-site-packages option) and activate it, e.g: :

   mkdir env; cd env
   virtualenv --system-site-packages .
   source bin/activate
   cd ..

4. Install dependencies: :

   pip install -r requirements.txt

5. Create writable uploads / cache directory: :

   mkdir static
   mkdir static/uploads
   chmod 777 static/uploads
   mkdir static/cache
   chmod 777 static/cache

6. Sync the database (and create a DB and DB user if necessary): :

   ./project/manage.py db upgrade

7. Create a super user to log in to the app: :

   ./project/manage.py createsuperuser

8. Run the development server (defaults to port 5000): :

   ./project/manage.py runserver -dr

9. Access the web front-end: :

   http://localhost:5000/

10. Access the admin by loging in: :

    http://localhost:5000/login/?next=/admin/

In project/settings.py, change USE_S3 to False to store the image locally. If using S3, you'll need to set S3_BUCKET_NAME, AWS_ACCESS_KEY_ID, and AWS_SECRET_ACCESS_KEY to point to a bucket that the given AWS credentials can read / write to.

For a comprehensive guide of how to use the Flask S3 tools demonstrated here, see this blog post:

http://greenash.net.au/thoughts/2015/04/storing-flask-uploaded-images-and-files-on-amazon-s3/