Reproducible research data analysis platform

Flexible

Run many computational workflow engines.

Scalable

Support for remote compute clouds.

Reusable

Containerise once, reuse elsewhere. Cloud-native.

Free

Free Software. MIT licence. Made with at CERN.

Examples
Get started
1

Structure your analysis

version: 0.8.1
inputs:
files:
- code/mycode.py
- inputs/mydata.csv
parameters:
myparameter: myvalue
workflow:
type: cwl
file: workflow/myworkflow.cwl
outputs:
files:
- results/myplot.png
more
2

Select a REANA cluster...

$export REANA_SERVER_URL=https://reana.cern.ch/
$export REANA_ACCESS_TOKEN=XXXXXXX

...or install your own

# install kubectl 1.19+, kind 0.9+ and helm 3.0+
$sudo dpkg -i kubectl*.deb kind*.deb kubernetes-helm*.deb
# create Kubernetes cluster (or use your own!)
$wget https://raw.githubusercontent.com/reanahub/reana/maint-0.8/etc/kind-localhost-30443.yaml
$kind create cluster --config kind-localhost-30443.yaml
$wget https://raw.githubusercontent.com/reanahub/reana/maint-0.8/scripts/prefetch-images.sh
$sh prefetch-images.sh
# deploy REANA using Helm
$helm repo add reanahub https://reanahub.github.io/reana
$helm repo update
$helm install reana reanahub/reana --wait
# create an admin user
$wget https://raw.githubusercontent.com/reanahub/reana/maint-0.8/scripts/create-admin-user.sh
$sh create-admin-user.sh default reana john.doe@example.org mysecretpassword
more
3

Run your analysis

# create new virtual environment
$virtualenv ~/.virtualenvs/myreana
$source ~/.virtualenvs/myreana/bin/activate
# install REANA client
$pip install reana-client
# create new workflow
$reana-client create -n my-analysis
$export REANA_WORKON=my-analysis
# upload input code and data to workspace
$reana-client upload ./code ./data
# start computational workflow
$reana-client start
# check its progress
$reana-client status
# list workspace files
$reana-client ls
# open interactive notebook session
$reana-client open jupyter
# download output results
$reana-client download results/plot.png
more
Documentation

Researchers

Find out how you can use REANA to describe, run, preserve and reuse your analyses.

User Guide

Administrators

Install and manage the REANA reusable analysis platform on your own compute cloud.

Administrator Guide

Developers

Understand REANA source code, adapt it to your needs, contribute changes back.

Developer Guide
Latest news

REANA 0.8.1

15 Feb 2022

Introduces custom job timeout limits for user workflows.

Allows searching workspace files by name and visualising HTML reports.

Improves Cluster Health status web page indicating cluster availability.

REANA participates at the HSF IRIS-HEP Analysis Ecosystems Workshop II, May 23-25 2022, Paris, France. [event]
A new paper "Scalable Declarative HEP Analysis Workflows for Containerised Compute Clouds" published in Frontiers in Big Data (2021). [paper]
Presented "Analysis Reproducibility with REANA on Kubernetes" as part of the CERN Cloud Containers webinar series (2020). [webinar] [event]
A technical overview of REANA published in EPJ Web Conf 2014 (2019) 06034. [paper]
REANA featured in the CERN Courier March/April 2019 thematic issue on Open Science. [paper]
An opinion piece "Open is not enough" about REANA and reproducible science solutions in particle physics published in Nature Physics 15 (2019) 113–119. [paper]
For all latest news follow us on Twitter
Roadmap

Current

Workflow launcher

Launch workflows from external sources such as source code repositories (GitHub, GitLab), digital repositories (Zenodo), or simply other locations on the web (generic URL) via "Launch-on-REANA" badges. [blog post]

Near-term

Workspace file retention

Introduce user-configurable workspace file retention policy allowing to specify that some files are to be deleted automatically 1 day after workflow finishes, other files retained for 356 days, etc. [rfc]

Future

Workflow sharing

Introduce user groups and role-based authorisation control models allowing to share workflows with colleagues.