Skip to main content

OpenFOAM horizon dashboard app.

Project description

This repository provides a horizon dashboard for the OpenFOAM cloud application. To use it, you must also install the backend application.

Installing via pip to an existing OpenStack Horizon installation

You can install the horizon-openfoam dashboard via pip package manager:

pip install horizon-openfoam

Edit openstack_dashboard/local/ and add the following parameters at the end:

OFCLOUD_API_URL         = 'your_ofcloud_api_url'
S3_ACCESS_KEY_ID        = 'your_s3_access_key_id'
S3_SECRET_ACCESS_KEY    = 'your_s3_secret_access_key'
S3_HOST                 = 's3 host'
S3_PORT                 = 443

The OFCLOUD_API_URL is the root URL of the OpenFOAM Backend.

To enable the dashboard copy to openstack-dashboard/openstack_dashboard/local/enabled (usually under /usr/share)

After installing restart your apache2 server where horizon is running.


systemctl restart apache2.service


systemctl restart httpd.service

Installing locally

In order to use the OpenFOAM Horizon dashboard, one must first clone the OpenStack’s Horizon project and checkout the Liberty version:

git clone
git checkout stable/liberty

Install the required packages (we suggest to use virtualenv for this):

cd horizon
pip install -r requirements.txt

Then add the ofcloud dashboard submodule

cd horizon/openstack_dashboard/dashboards/
git submodule add --name ofcloud ofcloud

In order to enable the dashboard, go to horizon/openstack_dashboard/enabled. This directory contains several files configuring the dashboards and panels. File ordering is important in that it sets the structure of the Horizon dashboard.

Create a file in this directory, for example and copy the following content:

# The name of the dashboard to be added to HORIZON['dashboards']. Required.
DASHBOARD = 'ofcloud'

# If set to True, this dashboard will not be added to the settings.

# A list of applications to be added to INSTALLED_APPS.

Finally, edit the local settings file (horizon/openstack_dashboard/local/ and put the following settings (replace with values appropriate to your system setup):

OFCLOUD_API_URL         = 'ofcloud-backend-url'
S3_ACCESS_KEY_ID        = 'your-s3-key'
S3_SECRET_ACCESS_KEY    = 'your-s3-secrect-key'
S3_HOST                 = 's3-host'
S3_PORT                 = s3-port

The OFCLOUD_API_URL is the root URL of the OpenFOAM Backend.


Start the OpenStack Horizon application, login and look for the OpenFOAM Cloud dashboard.

cd horizon
python runserver


This project has been conducted within the RIA MIKELANGELO project (no. 645402), started in January 2015, and co-funded by the European Commission under the H2020-ICT- 07-2014: Advanced Cloud Infrastructures and Services programme.

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for horizon-openfoam, version 1.0
Filename, size File type Python version Upload date Hashes
Filename, size horizon-openfoam-1.0.tar.gz (17.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page