# Medulla: Getting Started

Get started with Medulla for the first time with ease. This visual guide will help you perform your first tasks in Medulla: logging in, adding a device to the list, creating a package, and deploying that package to a device.

# On-Premises

# How to log in to Medulla

To access Medulla’s features, you must log in with your credentials. This step ensures the security of your data and personalized access.

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/pAvJcrjPZtkjwweK-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/pAvJcrjPZtkjwweK-image.png)

### Login Steps

#### Choose your language

On the login page, select your preferred language from the dropdown menu. The default language is French, but you can change it if necessary.

#### Enter your username

Enter the username and password for a GLPI or LDAP account, depending on the provisioning method defined during the configuration of your Medulla server.

OR

Log in directly via your OIDC if it is configured.

#### Enter your password

In the Password field, enter your personal password. Make sure it is spelled correctly: uppercase and lowercase letters are distinguished.

#### Confirm the login

Click the "Log In" button to access your user account.

<p class="callout info">For security reasons, avoid saving your password on shared devices.</p>

<p class="callout info">If you have trouble logging in, contact your organization’s technical support</p>

# Dashboard

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/kFlUHQl1JD5iJ4at-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/kFlUHQl1JD5iJ4at-image.png)

The Medulla dashboard allows you to monitor the real-time status of your infrastructure using customizable widgets. You can move, resize, and arrange the widgets as you wish. Each widget also has a button to show or hide it, depending on your needs.

Some widgets include dynamic charts for a better understanding of the data, updating in real time.

The following widgets allow you to create static groups directly so you can perform actions on them by clicking:

Inventory Widget, Operating System, Online Machines, Antivirus

### Available Widgets 


Widgets are organized by category and allow you to view various information about your infrastructure. Here are the main categories:

##### General

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/zvgwHw5pD3Mb5rS3-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/zvgwHw5pD3Mb5rS3-image.png)

##### Information provided 

- **Server name** (example: *devdemo.siveo.net on Debian GNU/Linux 12*)
- **Uptime** (time elapsed since the last system reboot)
- Total**RAM**, available RAM, and used RAM

##### Customization 

This widget can be moved wherever you like, and it is resizable to display more or less information depending on your needs. You can also hide it using the toggle if you don’t need to see this information all the time.

##### Graphical representation 

<div id="bkmrk-le-widget-g%C3%A9n%C3%A9ral-in" style="text-align:justify;">The General widget includes a **line chart** for**CPU usage** and a **pie chart**for**RAM usage**, allowing for a quick and intuitive visualization of system resource usage. The RAM chart shows the distribution of free and used space, while the CPU load chart helps you monitor server performance in real time.</div><div id="bkmrk--4" style="text-align:justify;padding-left:40px;"></div>[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/jcJIcc3UA5GcxXQY-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/jcJIcc3UA5GcxXQY-image.png)

#### Online machines

##### Information provided 

<div id="bkmrk-nombre-total-de-mach" style="text-align:justify;">- Total number of online and offline machines.

</div>##### Customization 

This widget can be moved and resized as you like. The toggle allows you to show or hide it according to your preference.

##### Graphical representation 

Pie chart to visualize the distribution of online and offline machines.

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/HQq5VSYvctqe7OFl-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/HQq5VSYvctqe7OFl-image.png)

#### Inventory

##### Information provided 

- Total number of items in the inventory and those that haven't been updated in over 10 days.

##### Customization

The widget is customizable and can be moved and resized. You can also hide it if you don’t need it.

##### Graphical representation

A **pie chart**displays the items in the inventory and highlights those requiring an update, providing an overview of the inventory’s status

<p class="callout info">In summary, the **Dashboard** is your centralized hub for managing and monitoring the status of your IT infrastructure. It is designed to be **flexible and responsive**, providing an overview of the performance of your machines and resources, while allowing you to react quickly to any alerts or necessary updates.</p>

<p class="callout info">With this set of tools and **graphical visualizations**, the Dashboard gives you optimal control to **manage your systems efficiently**, while providing a clear and detailed view of your entire IT environment.</p>

# Adding a computer in Medulla

The Medulla agent can be downloaded from

http://medulla.domaine.lan/downloads/win/Medulla-Agent-windows-FULL-latest.exe

The Medulla agent can be installed manually or in silent mode:

 "Medulla-Agent-windows-FULL-latest.exe /S"

The installation process will continue after the installation is complete; it will install all dependencies.

It is complete when the computer appears in Medulla in blue (online).

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/gzEwlM82XWYuG76C-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/gzEwlM82XWYuG76C-image.png)

#### Medulla Agent

**By default, we provide a global agent for Medulla (**as explained in this post).**Entity management per workstation is handled via GLPI.**

However, if you wish**to benefit<span class="followup-block followup-block-hidden cursor-pointer outline-none static inline group-hover/message:[--hover-opacity:1]" tabindex="0">from automatic assignment of machines to entities directly via the agent</span>**, it is also possible to**<span class="followup-block followup-block-hidden cursor-pointer outline-none static inline group-hover/message:[--hover-opacity:1]" tabindex="0">generate entity-specific agents</span>**. This option<span class="followup-block followup-block-hidden cursor-pointer outline-none static inline group-hover/message:[--hover-opacity:1]" tabindex="0">is not enabled by default</span>, but<span class="followup-block followup-block-hidden cursor-pointer outline-none static inline group-hover/message:[--hover-opacity:1]" tabindex="0">we can assist you in setting it up</span>if it meets your needs. To view agents by Entity:[Entity Management](https://docs.medulla-tech.io/books/medulla-guide-dutilisation-pas-a-pas/page/gestion-des-entites-dans-medulla)

# Creating your first package

Link to the complete package module:

[https://docs.medulla-tech.io/books/medulla-guide-dutilisation-pas-a-pas/chapter/chapitre-8-packages](https://docs.medulla-tech.io/books/medulla-guide-dutilisation-pas-a-pas/chapter/chapitre-8-packages)  
  
-

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/dPbH3e98vMnA7abc-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/dPbH3e98vMnA7abc-image.png)

Creating a package involves defining an action (installation, uninstallation, script, etc.) that will be deployed on one or more workstations. The creation form allows you to precisely configure the package’s behavior and its execution options.

**Here we will create a simple package, without adding a workflow, solely to install a simple application such as Notepad++.**

From the main menu, go to the "Package" view, click**"Add a package"**to open the creation wizard.

Next, select the source of the files to be used in the package. Four options are available:

- Already on the server
- Upload from this page
- Create an empty package

Use a Notepad++ installer, for example, then click:

- **Upload from this page**  
    Import the installation files directly from your computer.
- Don’t forget to click “Send pending files.”

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/0qnUd6JTWqYjTiNw-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/0qnUd6JTWqYjTiNw-image.png)

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/2EK4VFHwf9bMmRMA-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/2EK4VFHwf9bMmRMA-image.png)

#### General information to provide 

##### Share 

Select*Global Packages* to make the package visible across the entire platform, for all Entities.

##### Name 

Give the package a descriptive name, for example: InstallNotepad  
*Special characters (except: \_ and -) and accented characters are not allowed.*

##### Version 

Specify a version number, e.g., 1.0.0 or the Notepad++ version.

##### Description

Briefly summarize the purpose of the package.

##### Operating System 

Select the target OS, for example:*Windows*.

##### Transfer method   


Generally, use pushrsync (recommended): Server -&gt; Rsync -&gt; Machine.

##### Link to inventory   


Enable this option to allow tracking of the package after installation via the GLPI inventory, if desired.

As you type the first three letters, autocomplete will activate.

*Auto-completion is based on the existing inventory in GLPI.*

##### You can add custom actions to the package, depending on your needs:

Here, our wizard will automatically determine, based on rules, the correct command to run the installation file to install the application in silent mode.

- Run a command or script (When adding a file to the "Package Source" package, our wizard automatically adds the correct command to run the setup file and silently install the application)

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/o1eAZ2zABQjJpggG-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/o1eAZ2zABQjJpggG-image.png)

##### Once all sections have been configured and verified 

Click**Add**to save the package.

It will then be accessible from the "Packages &gt; Package List" library for use in a deployment.

*It will temporarily appear in the "Pending Packages List" if you have relays. This list shows the progress of the package synchronization across all your relays, if you have any.*

For a complete guide on creating packages: [Complete Package Creation](https://docs.medulla-tech.io/books/medulla-guide-dutilisation-pas-a-pas/page/creer-un-package)

# Package deployment

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/OFpqMOaInSY6XqtH-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/OFpqMOaInSY6XqtH-image.png)

Here we will deploy the package created earlier.

Go to the **Computer** view **and** select a workstation. Click the deployment button:

![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/kFeFBTMsgixJaWhV-image.png) **Software Deployment -**  Remote software installation or update.  
  
Find the new package you created earlier in the package list and click the instant deployment icon:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/gvv0p9sb31PKQldb-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/gvv0p9sb31PKQldb-image.png)

![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/lXxicyLa1bFKxh3b-image.png) **Launch Action** - Deploys the package to the previously selected workstation.

When you start a deployment, you are automatically redirected to the Deployment Audit page.

Otherwise, go to the **"Audit"** view; a new row will appear, allowing you to track the progress of the deployment you just performed.

See the page: [Deployment Audit](https://docs.medulla-tech.io/books/medulla-premier-pas/page/suivre-laudit-dun-deploiement)

# Track the audit of a deployment

Would you like to view the audit of a deployment? Go to the Audit view in the navigation bar.

Search for your deployment by name, which includes the deployment start date and time as well as other useful information.

On the row for your deployment’s audit, on the far right, you’ll find the button that lets you view the full deployment audit: ![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/zSKpQNwMzhay8YzM-image.png)

You will then be redirected to a new page that includes all the details of the deployment:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/UkfzyTjL55AocHGF-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/UkfzyTjL55AocHGF-image.png)

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/95vdgArdVAavlGDn-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/95vdgArdVAavlGDn-image.png)

# SaaS

# How to log in to Medulla

After subscribing to our SaaS offering, you should have received a link to access our platform.

Simply enter your email address there to receive a "*Magic Link"* that will allow you to log in to your account.

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-11/scaled-1680-/Z6QZD4Mv9RLw8D6h-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-11/Z6QZD4Mv9RLw8D6h-image.png)


### Login Steps

#### Choose your language

On the login page, select your preferred language from the dropdown menu. The default language is French, but you can change it if necessary.

#### Enter your username

Before configuring your OIDC, users, and entities, you must log in for the first time using the information provided in the email containing your SaaS contract.

#### Confirm the login

Click the "Log In" button to access your user dashboard.

<p class="callout info">For security reasons, avoid saving your password on shared devices.</p>

<p class="callout info">If you encounter any login issues, contact your organization’s technical support</p>

# Dashboard

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/scaled-1680-/abmVy8L9cdCszgid-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/abmVy8L9cdCszgid-image.png)

The Medulla dashboard allows you to monitor the real-time status of your infrastructure using customizable widgets. You can move, resize, and arrange the widgets as you wish. Each widget also has a button to show or hide it, depending on your needs.

Some widgets include dynamic charts for a better understanding of the data, updating in real time.

The following widgets allow you to create static groups directly so you can perform actions on them by clicking:

Inventory Widget, Operating System, Online Machines, Antivirus

<p class="callout info">In summary, the **Dashboard** is your centralized hub for managing and monitoring the status of your IT infrastructure. It is designed to be **flexible and responsive**, providing an overview of your machines’ and resources’ performance while allowing you to react quickly to any alerts or necessary updates.</p>

<p class="callout info">With this set of tools and **graphical visualizations**, the dashboard gives you optimal control to **manage your systems efficiently**, while providing a clear and detailed view of your entire IT environment.</p>

# Adding a computer in Medulla

Once logged in to your interface, go to the **"Admin" &gt;  "Entity Management"** view.

You can download your agent directly by clicking the [![download.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/scaled-1680-/zIcdC5dKmKRD7hpE-download.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/zIcdC5dKmKRD7hpE-download.png) **"Download"** button in the **"Actions"** section on the right side of your entity.

`Note: Each entity has its own agent, which helps maintain separation between entities.`

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/scaled-1680-/Bqfp5l3fGgDdkaHN-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/Bqfp5l3fGgDdkaHN-image.png)

> **<span style="color:rgb(224,62,45);">Important Information</span>**
> 
> <span style="color:rgb(0,0,0);">When you install an agent on a Windows machine, it must be **restarted**; the agent **will prompt** you to restart the computer.  
>   
> Once restarted, **it**may take up to **5 minutes** for your computer **to appear**in the "Computers" section of your interface **.**</span>
> 
> <span style="color:rgb(0,0,0);">It may take up to 20 minutes for the machine to **fully initialize** for the first time and appear as**"Online"** on your interface.</span>

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/scaled-1680-/jmR3H7NQBA64PsRu-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/jmR3H7NQBA64PsRu-image.png)

# Creating your first package

Link to the complete package module:

[https://docs.medulla-tech.io/books/medulla-guide-dutilisation-pas-a-pas/chapter/chapitre-8-packages](https://docs.medulla-tech.io/books/medulla-guide-dutilisation-pas-a-pas/chapter/chapitre-8-packages)  
  
-

Creating a package involves defining an action (installation, uninstallation, script, etc.) that will be deployed on one or more workstations. The creation form allows you to precisely configure the package’s behavior and its execution options.

**Here we will create a simple package, without adding a workflow, solely to install a simple application such as Notepad++.**

From the main menu, go to the "Package" view, click**"Add a package"**to open the creation wizard.

Next, select the source of the files to be used in the package. Four options are available:

Get a Notepad++ installer, for example, then click:

- **Upload from this page**  
    Import the installation files directly from your computer.
- Don’t forget to click “Submit pending files.”

#### General information to provide 

##### Share 

Select*Global Packages* to make the package visible across the entire platform, for all Entities.

##### Name 

Give the package a descriptive name, for example: InstallNotepad  
*Special characters (except: \_ and -) and accented characters are not allowed.*

##### Version 

Specify a version number, e.g., 1.0.0 or the Notepad++ version.

##### Description

Briefly summarize the purpose of the package.

##### Operating System 

Select the target OS, for example:*Windows*.

#### Define the technical deployment details 

##### Transfer method   


Generally, use pushrsync (recommended): Server -&gt; Rsync -&gt; Machine.

##### Link to inventory   


Enable this option to allow tracking of the package after installation via the GLPI inventory, if desired.

As you type the first three letters, autocomplete will activate.

##### You can add custom actions to the package, depending on your needs:

Here, our wizard will automatically determine, based on rules, the correct command to run the installation file to install the application in silent mode.

- Run a command or script (When adding a file to the "Package Source" package, our wizard automatically adds the correct command to run the setup file and install the application silently)

##### Once all sections have been configured and verified 

Click**Add**to save the package.

It will then be accessible from the "Packages &gt; Package List" library for use in a deployment.

# Package deployment

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/scaled-1680-/Rb8P7M9VgW5mgR2v-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/Rb8P7M9VgW5mgR2v-image.png)

Here we will deploy the package created earlier.

Go to the **Computer** view **and** select a workstation. Click the deployment button:

![deploy.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-05/scaled-1680-/deploy-png.png) **Software Deployment -**  Remote software installation or update.  
  
Find the new package you created earlier in the package list and click the instant deployment icon:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/scaled-1680-/8oOVX6fV55Lcy1L9-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/8oOVX6fV55Lcy1L9-image.png)

![play.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/scaled-1680-/AsYRutlfZRaLLyoO-play.png) **Run Action** - Deploys the package to the previously selected workstation.

Go to the **"Audit"** view; a new row will appear.

A new row appears, allowing you to track the progress of the deployment you just performed.

# Track the audit of a deployment

Go to the **"Audit"** view; a new line will appear.

A new row appears, allowing you to track the progress of the deployment you just performed.

# Create my first entity

![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/scaled-1680-/d4qMqwnOTTBdtGal-image.png)

  
An initial entity named after your organization will be created.

To create your first sub-entity, go to the **"Admin"** module.

Once in the **"Admin"** module, navigate to the "**Entity Management"** submenu on the left.

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/scaled-1680-/NSKkYlwmcMdLRReo-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/NSKkYlwmcMdLRReo-image.png)

Click the " ![add.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/scaled-1680-/dfpXx0GNes8aRSbK-add.png) " button on your entity's row to add a sub-entity.

![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/scaled-1680-/yiJnxJXYNfaSMy4P-image.png)

You can enter the name of your first entity belonging to your organization here; once the name is entered, click the **"Create Entity"** button **.**

![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/scaled-1680-/r5D4uE3SjBz6ipq4-image.png)

You are now able to create entities and sub-entities. There is no limit to the number of entities you can create.

A user who is part of the highest entity in the hierarchy can manage lower-level entities; however, the reverse is not possible, even for the entity’s Super-Admin.

Two entities at the same hierarchical level remain isolated: they have access only to their own information and cannot under any circumstances view that of others, even if they are at the same level.

# Add your first user

![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/scaled-1680-/XC32rrt4LwuPggSB-image.png)

  
Now that you have created your first entity, it is time to define a user for it.

Go to **"Add a User"** in the left-hand menu.

![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/scaled-1680-/IsF1e1NiFQfWPDqs-image.png)  
Here you have the choice between several profiles:

- Super-Admin
- Admin
- Technician

Manage them as you see fit.

You can then choose:

This user's entity

Their recursion, whether they can see entities subordinate to them. (default: Yes)

Then enter their login and personal information (authentication will be via email/password).

- Email
- Password
- First Name
- Last Name
- Phone number

Finally, click the **"Create a new user"** button.

# Set up your first OIDC provider

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/scaled-1680-/JqUvMkgIHIhvu1Os-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-09/JqUvMkgIHIhvu1Os-image.png)

If you do not wish to authenticate using standard users, you can configure one or more providers (OIDC, SSO).

The "provider name" field is for display purposes only; the logo is optional.

Then enter the provider configuration:

- URL
- ID
- Secret

You can then configure the LDAP attributes.

- uid
- givenName
- sn
- mail