1. Academy
  2. Object Store

How to connect to the Fuga Cloud Object Store using Flask

Connecting to the Fuga Object Store with Flask

The possibilities with the Fuga Object Store are endless. One of the scenarios is connecting your Flask application to the Fuga Object Store, this way you can access for example images on your Store! In this tutorial, we will teach you how to make a simple Flask file upload application that uses the Fuga Object Store.

API keys

To connect to your Fuga Object Store access and secret keys are required. If you already have these you can skip this chapter.

  1. To list and create API keys for the Object Store we need the Fuga OpenStack CLI. If you haven’t installed it yet check out our tutorial.

  2. After following the tutorial for your operating system it’s time to list the credentials. We need the credentials to access our Object Store container in later steps.

  3. To list all the credentials, enter the command:

openstack ec2 credentials list
  1. If the list of credentials is empty, a new pair of credentials can be generated with:
openstack ec2 credentials create
  1. Either copy the Access and Secret key to the clipboard or save them temporarily

Creating a Fuga Object Store container

  1. Open your Fuga Dashboard and open the ‘Object Store’ section.

  2. Click on ‘Containers’ and create a new container.

We now have a container that is ready to be used in the upcoming steps.

Attaching the container to an existing Flask application

  1. Next up is installing boto, this package is required because it allows us to easily connect to the Fuga Object Store. Install the boto package in your Flask project with the following command:

    pip install boto

  2. Create a new folder for your project, for example, flaskfuga:

    mkdir flaskfuga
  3. Open the folder:

    cd flaskfuga
  4. Create a new Python file within your flaskfuga folder called something like ‘object_store.py’:

    touch object_store.py
  5. Open object_store.py in your favorite editor and copy paste the Python code from our GitHub.

Uploading files to your Fuga Object Store container

  1. Create a new app.py in your flaskfuga folder using the following command:

    touch app.py
  2. Open the app.py file in your favorite editor and copy paste the following:

    from flask import Flask, render_template, request
    from object_store import FugaObjectStore


    app = Flask(__name__)

    def index():
    return render_template('index.html')

    @app.route('/upload', methods=["POST"])
    def upload_file():
    file = request.files['file']

    with FugaObjectStore(ACCESS_KEY, SECRET_KEY, CONTAINER_NAME) as fuga:
    fuga.upload(file, file.filename)

    return render_template("index.html")

    @app.route('/list-images', methods=["GET"])
    def list_images():
    html = ""

    with FugaObjectStore(ACCESS_KEY, SECRET_KEY, CONTAINER_NAME) as fuga:
    files = fuga.list()
    for file in files:
    current_file = fuga.get(file)
    html += "<image src='data:image/png;base64, " + current_file + "'>"

    return html

    if __name__ == '__main__':
  3. Place your own access and secret keys in the correct variables

  4. Make sure your flaskfuga directory contains a directory called templates, create it with the following command:

    mkdir templates
  5. Next up is creating a view for our file upload. Create a file in your templates called index.html.

  6. Copy paste the following code inside index.html:

    <title>Upload to Fuga Object Storage</title>
    <h1>Upload to Fuga Object Storage</h1>
    <form action="/upload" method="POST" enctype="multipart/form-data">
    <input type="file" name="file"/>
    <br />
    <input type="submit" value="Upload File" />
  7. Run your Flask application with:

    python app.py
  8. Head to to use your Flask application

  9. Try to upload an image and check on your Fuga Cloud Dashboard if the image has been added to your Fuga Object Store container.

Listing stored images from your Fuga Object Store

  1. Add the following method to your app.py:

    @app.route('/list-images', methods=["GET"])
    def list_images():
    files = fuga.get_files()
    html = ""
    for file in files:
    html += "<image src='data:image/png;base64, " + fuga.get_file(file) + "'>"
    return html
  2. Save the changes and restart your Flask application.

    python app.py
  3. Now you are able to retrieve your uploaded images on

See our GitHub page for the full project.