# Matomo - Get started
## Create a Matomo instance
Connect to ITCare platform, click on the Analytics button in the main menu on the left
Click on "**Create a Matomo Instance**" and follow the instructions.
Provide the global service in which you want to create a Matomo instance into.
Give the name of the instance you want to create.
A default website name and URL can be configured during provisioning. It's optional. If left empty, dummy values will be used. Click **Next**.
Pick the sizing of the Matomo Analytics instance matching your needs and click **Next**:
Provide the password of the super user named "administrator" that will be given to you.
{% hint style="warning" %}
The super user's password is not saved by cegedim.cloud.
Make sure to save your password!
{% endhint %}
At the next step, you can configure management options :
* Monitoring (highly recommended)
* 24/7 monitoring
* Backup (highly recommended)
* Storage replication
Click **Next**.
Select the **region** in which you want to create your Matomo instance. Click **Next**.
Verify your inputs in the synthesis page. You can :
* Check the instance that will be created
* See the target global service
* Save your administrator password.
* Verify the management options.
Click **Submit** when ready to submit.
Once the instance is ready, you will be notified by email with the information required to connect to it. Instance creation can take up to 2 hours based on the current load on automation.
The instance will then be displayed in the management page in the Analytics section.
## Start a Matomo instance
Go to the "**Analytics**" menu from the left main menu and click on the manage link. Once presented with all the Matomo instances, click on the **Start** button of the instance of your choice.
{% hint style="warning" %}
Starting a Matomo instance will start all components.
{% endhint %}
An email notification will be sent when the service will be activated.
## Stop a Matomo instance
Go to the "Analytics" menu from the left main menu and click on the manage link. Once presented with all the Matomo instances, click on the stop button of the instance of your choice.
Input an RFC number for tracking (optional) then submit by clicking on Stop.
{% hint style="warning" %}
Stopping a Matomo instance will stop all associated components and monitoring will be disabled.
{% endhint %}
An email notification will be sent when the instance is stopped.
## Delete a Matomo instance
Go to the "Analytics" menu from the left main menu and click on the manage link. Once presented with all the Matomo instances, click on the delete button of the instance of your choice.
{% hint style="info" %}
You can only delete a previously stopped instance !
{% endhint %}
This action will **delete** all components used by that Matomo instance.
{% hint style="danger" %}
Please note that this action is not recoverable.
{% endhint %}
Input an RFC number for tracking (optional) and the instance name (mandatory) to confirm your choice then click **Delete**.
An email notification will be sent when the instance is removed.
## Resize a Matomo instance
Go to the "Analytics" menu from the left main menu and click on the manage link. Once presented with all the Matomo instances, click on the resize button of the instance of your choice.
{% hint style="info" %}
Only an instance already started can be resized.
{% endhint %}
Select the new size that can only be higher than current one and click on **Resize**.
{% hint style="danger" %}
Service will be interrupted.
{% endhint %}
An email notification will be sent when the instance is resized.
## Install Matomo plugins
Connect to your Matomo Analytics instance with the "administrator" user you provided during provisioning.
Click on the Administration icon :\\
Select Extensions menu
Go at the end of the page and click on the "Install new components" button:
Look for, install and activate modules at your own discretion:\\
## Update Matomo software version
Connect to your Matomo Analytics instance with the "administrator" user.
Click on the adminitration icon
Click at the top of the page on the message indicating a new version
Confirm the automatic upgrade\\
Wait until the end of the upgrade with success message\\
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://academy.cegedim.cloud/analytics/matomo/matomo-get-started.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
