Animated DataLad logo

The Handbook



You are viewing the INM-7-specific version of the handbook. Most content will be identical, but if you didn’t end up here intentionally, it’s best to read the public version of the handbook at

This handbook is a living resource about why and – more importantly – how to use DataLad. It aims to provide novices and advanced users of all backgrounds with both the basics of DataLad and start-to-end use cases of specific applications. If you want to get hands-on experience and learn DataLad, the Basics part of this book will teach you. If you want to know what is possible, the use cases will show you. And if you want to help others to get started with DataLad, the companion repository provides free and open source teaching material tailored to the handbook.

Before you read on, please note that the handbook is based on at least DataLad version 0.12, and the higher your version of DataLad is, the better. The section Installation and configuration will set you up with what you need if you currently do not have DataLad 0.12 or higher installed.

If you’re new here, please start the handbook here. Alternatively, try to identify with one of several user-types in this user specific guide to the handbook.

The handbook is currently in beta stage.

If you would be willing to provide feedback on its contents, please get in touch.


The fundamentals of DataLad



Code lists from chapters