Get Started
New to Legend? Read What is Legend? first, then pick a way to try it below.
Start Using Legend Today
Studio hosted instance
FINOS hosts a shared instance of Legend, which needs no installation. It runs an older version of Legend than the latest release, so some features in these docs may be missing there.
Instructions to sign up are on the FINOS website.
Note: this is a shared instance. Every project on it can be read by the public, so don't use it for proprietary data models.
Using Legend Omnibus
Legend Omnibus runs Legend Studio, its servers and their dependencies on your machine with Docker. Make sure you have Docker installed, then run:
curl https://legend.finos.org/omnibus/start.sh | bash
# Or run the full Omnibus, with an embedded GitLab, which takes longer to start
curl https://legend.finos.org/omnibus/start.full.sh | bash
When it's ready, Legend Studio is at http://localhost:6900/studio.
The Omnibus images were last published in January 2025, and the full image in December 2023, so they run an older version of Legend than the latest release. See the Omnibus guide for other ways to run it, such as with your own gitlab.com account.
Run Legend from source
To run the latest Legend, build it from source. The Installation Guide explains how to run the servers. The applications run from finos/legend-studio: its README explains how to start each one locally.
Learn Legend
- Showcase projects are small, working examples of each feature. Browse them in Legend Studio's Showcase Explorer, from its start screen, or on the Showcase projects page.
- Tutorials walk through Legend Query step by step, and the Legend Studio features its guide doesn't cover yet, such as service stores and persistence.
- Guides explain each application's screens: the Legend Studio, Legend Query and Legend Cube guides.
- Reference pages describe the Legend language, the Relation API, Legend SQL and every function.
- The Glossary defines the terms used across Legend.
Introductory videos
These sessions for the FINOS community, hosted by Beeke-Marie Nelke, introduce Legend Studio and Legend Query:
- Legend 101: the basics of data modeling in Legend Studio.
- Legend New Feature Deep Dive: how to create mappings and query your data.
More recordings are on the Legend media page.