← Back to news

eLabFTW integration

Bring data to Galaxy straight from the lab.

eLabFTW is a free and open source electronic lab notebook from Deltablot. It can keep track of experiments, equipment and materials from a research lab. Each lab can either host their own installation or go for Deltablot's hosted solution. A live demo showcasing its features is available here.

And from now on, it is integrated with Galaxy! eLabFTW support has been deployed to usegalaxy.eu, and the file source will be brought onboard to upstream Galaxy in release 25.0. This means that files attached to eLabFTW experiments and resources can be imported to histories with just a few clicks. After the analysis is complete, datasets and histories can be exported back as attachments to an experiment or resource.

Getting started

Before it can be used, the feature must be enabled by a Galaxy administrator. Once enabled, navigate to the Settings page on your eLabFTW server and go to the API Keys tab.

eLabFTW API Keys tab on settings page

Generate a new API key and copy it. Choose "Read/Write" permissions to enable both importing and exporting data. "Read Only" API keys work for importing data to Galaxy, but not for exporting data to eLabFTW.

Creating a new API key

On Galaxy, configure a new eLabFTW file source under user preferences Manage Your Repositories > Create > eLabFTW.

User preferences

Manage Your Repositories

Select eLabFTW

Assign a name to your eLabFTW file source, enter the URL to your eLabFTW instance, and enter the API key you just generated. If you are using a "Read Only" API key, disable the toggle "Allow Galaxy to export data to eLabFTW?". Click Create.

eLabFTW file source setup on Galaxy

Importing files to a Galaxy history

To import files from eLabFTW to a Galaxy history, click Upload on the sidebar and then Choose remote files.

Galay upload tool

Remote file sources

After selecting eLabFTW, Galaxy shows two folders, one that contains all experiments and another that contains all resources.

eLabFTW experiments and resources listed by Galaxy

Inside each, all experiments or resources are listed as folders. Attached files are located within each of the folders.

Experiments listed by Galaxy

Files attached to the microscopy experiment

Exporting histories to eLabFTW

Clicking Export History to File under History options opens the history export screen. There, select to remote file, choose a name, and finally use the box Click to select directory to open the remote file source browser. The same screen displayed when importing files will be shown, from where you can select a target experiment or resource.

History export screen

Keep in mind that you have to create the experiments and resources themselves on eLabFTW beforehand.

Exporting datasets to eLabFTW

Individual datasets may also be exported with the help of the dataset export tool. First, choose the datasets to export under the What would you like to export? section. Then click Select under Directory URI to open the remote file source browser, which allows to select the target experiment or resource.

Dataset export tool