EPI2ME Labs Quick Start

May 17, 2022
2 min read

EPI2ME Labs extends the JupyterLab notebook framework with a pre-configured analysis environment and the ability to run Nextflow workflows all in a single desktop application. Our Nextflow workflows can be used to routine analyses, while our notebooks provide an introduction to nanopore sequencing bioinformatics and provide next steps for a selection of our workflows.


The first time EPI2ME Labs is started the environment components must be downloaded. This will not happen on subsequent server starts. After the components have been downloaded the Lab environment will start.

Running a Workflow

  1. On the landing page select the workflow you would like to open.
    Workflow launch
    Launch a workflow
  2. Scroll through the form and fill out required fields, required fields will be indicated with a red cross, which will turn to a green tick when filled out correctly. Click Launch workflow.
    Workflow launch
    Launch a workflow
  3. The workflow should start running and give an indication it is has launched and when complete it should provide output files.
    Workflow launch
    Launch a workflow
  4. Click on instance details for further information about the run and for an option to re-run.

Running a Tutorial

  1. On the landing page select notebooks in the top right corner and select the notebook template you wish to open. The template will create a copy of the file as a new document for you to edit.
    Notebook launch
    Launch a notebook
  2. You can see all your data in the location you provided in settings by clicking /epi2melabs in the sidebar:
    epi2melabs mount
    Data access from epi2melabs folder
  3. To copy your own data into the tutorial, right-click on the data file and select Copy path.
    Copy filepaths
    Copying filepaths
  4. Follow the guidance provided in the tutorial to perform data analysis.

Running code cells

Running code cells requires clicking the play button in the navigation bar at the top of the screen (or to the right-hand side of a code cell). There is also a “Run” tab that can be used to run multiple cells.

Run code cells
Running code cells

Bookmarks and navigating notebooks

The environment provides a table of contents menu in the left-hand sidebar. These navigation prompts can also be used to fold content visibility in the notebook.

Notebook Bookmarks

Updating the Environment

The EPI2ME Labs application automatically detects when updates are available to the notebok server. Oxford Nanopore Technologies’ may occassionally provide updates to provide new features or improved performance.

When an update is available attempting to start or restart the notebook server when an update is available will result in the following being displayed:

Update available
Server update available

To update the server or launcher select update from the setting menu (bottom left hand cog), The new components will be downloaded:

Update download
Server updating

Application settings

To access the application settings click the bottom left hand cog and click Settings.

option screen
The EPI2ME Labs application required minimal configuration. Users are advised to change the Security Token setting to a unique value.

The Data Mount option controls the path where data from Nextflow workflows and Jupyter notebooks is save.

We strongly encourage updating the security token to a unique value. The token provides an authentication method that allows only trusted users access to the EPI2ME Labs server and is used as an additional security layer to help prevent other users on the network from running code and accessing data. This token will be used later in the workflow to connect Google Colaboratory to the server.

Changing these settings will cause the Lab environment to restart.

Table Of Contents

Running a Workflow
Running a Tutorial
Updating the Environment
Application settings

Quick Links

TutorialsWorkflowsOpen DataContact

Social Media

© 2020 - 2023 Oxford Nanopore Technologies plc. All rights reserved. Registered Office: Gosling Building, Edmund Halley Road, Oxford Science Park, OX4 4DQ, UK | Registered No. 05386273 | VAT No 336942382. Oxford Nanopore Technologies, the Wheel icon, EPI2ME, Flongle, GridION, Metrichor, MinION, MinIT, MinKNOW, Plongle, PromethION, SmidgION, Ubik and VolTRAX are registered trademarks of Oxford Nanopore Technologies plc in various countries. Oxford Nanopore Technologies products are not intended for use for health assessment or to diagnose, treat, mitigate, cure, or prevent any disease or condition.