Tags: intro

Welcome to the LinkAhead Documentation#

Important

This new documentation page is currently work-in-progress!

Tags: Tags

Quickstart#

As LinkAhead is composed of multiple software components, different audiences have different needs, where to start reading the docs. This section aims at guiding different user groups into the right direction.

  • Users just wanting to use LinkAhead (mostly via the web front-end) will most likely have a look at: Users

  • Advanced users who do not only want to use the web interface, but also APIs and client libs (like the Python interface) should head to the section: Advanced Users

  • Everyone who would actually like to touch LinkAhead source code (no matter whether pylib, server, mysql, …) should have a look at the Development section.

  • Documentation needed for setting up and maintaining a LinkAhead instance is placed in the category: Admins

Introduction#

Innovative and customer-centric companies in particular are increasingly confronted with enormous amounts of data, data of high complexity and changing data structures. LinkAhead can help you unearth this often still hidden treasure trove of data.

The dynamic toolbox LinkAhead enables professional data management where other approaches are too rigid and inflexible. When your requirements change, due to new circumstances, upgraded equipment or evolving needs, traditional databases are costly to adapt, if possible at all. With LinkAhead, however, these adaptations are already built in by design and easily possible whenever necessary. LinkAhead thus enables professional data management in areas which previously could not benefit from it.

LinkAhead was originally developed under the name CaosDB at the Max Planck Institute for Dynamics and Self-Organization in Göttingen for the management of laboratory data, because classical databases could not meet the requirements for flexible adaptability. In 2018, LinkAhead was released as open source software and has since been commercially supported by IndiScale. A ready-to-use distribution of LinkAhead is offered via a subscription by IndiScale under the brand LinkAhead. In order to provide maximum reliability to customers, IndiScale performs a thorough quality assurance, for example by employing extensive automated testing. The LinkAhead subscription provides these qualities and benefits like reduced maintenance efforts to customers.

LinkAhead uses Docker to assure a reproducable execution environment. The debian package will install every thing that is necessary to start LinkAhead in a Docker container. The Docker image that contains most of the software dependencies is not included in the Debian package but will be downloaded by Docker on first execution.

This documentation describes how to install, configure and use LinkAhead.

Users#

Advanced Users#

  • Quickstart

https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html#confval-intersphinx_mapping#

intersphinx_mapping = { “python”: (“https://docs.python.org/”, None), “server”: (“https://docs.indiscale.com/caosdb-server/”, None), “crawler”: (“https://docs.indiscale.com/caosdb-crawler”, None), “advanced”: (“https://docs.indiscale.com/caosdb-advanced-user-tools”, None), “mysqlbackend”: (“https://docs.indiscale.com/caosdb-mysqlbackend”, None), “pylib”: (“https://docs.indiscale.com/caosdb-pylib”, None), “webui”: (“https://docs.indiscale.com/caosdb-webui”, None), }

Developers#

Admins#

Installation Guides#

LinkAhead is composed of multiple subprojects. Each of them has it’s own installation guide, contained as markdown file in the respective source code repository.

Indices and tables#

Report an issue#

Please report all bugs, feature request, or other issues with LinkAhead itself or this documentation by opening an issue in the official LinkAhead issues repository.