Run Medatarun

This page assumes Medatarun has been installed and the medatarun command is available in your shell. See install.

Launch the server

Simply run

medatarun serve

You will see logs in the console. To stop the server, CTRL+C or Kill.

Now you can browse on http://localhost:8080 to verify that everything is running correctly.

First access (admin account)

At first startup, Medatarun does not contain any users yet.

To actually start using it, you need to obtain an initial administrator access. This is a one-time bootstrap step.

Follow the instructions in Managing users to create or obtain the initial admin account.

Once this is done, you can log in and start working with Medatarun.

What next?

From here, you can interact with Medatarun in different ways, depending on what you want to do.

Using the UI

Open your browser at http://localhost:8080 to create, import, explore models visually.

Using the CLI

Run commands from your terminal to import models, inspect them, or automate workflows.

See CLI usage

Using the API

Integrate Medatarun into your own tools, scripts, or services. See API documentation

Using AI Agents with MCP

Connect Medatarun to AI agents or LLM-based tools. See Using with AI Agents

Thinking about production: if you’re starting to think about deployment, networking, or runtime behavior, configuration options are documented here. See configuration page when you are ready for production usage.