> For the complete documentation index, see [llms.txt](https://docs.voltmasters.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.voltmasters.io/voltmasters-platform/10.-project-settings/10.5-project-settings.md).
# Project settings
Under **Settings → Project Settings → General Settings**, you configure the core parameters that govern how the EMS manages energy for this project. These settings affect grid protection, battery strategy and energy contract optimisation.
Save changes using the **Save** button at the bottom of the page.
### Project details
| Field | Description |
| ---------------- | ------------------------------------------------------------------------ |
| **Project name** | The name of the customer or site, as it appears throughout the platform. |
| **Address** | The physical address where the EMS controller is installed. |
Voltmasters EMS: project details
### Grid settings
#### Main meter
Select the energy meter that acts as the **main meter** (head meter) for this installation. This is the meter that measures the total exchange with the electricity grid. Reports, dashboard figures and many screens that display grid data use this meter as their primary source.
#### Grid connection type
Configure whether the installation is **single-phase** or **three-phase** to match the actual grid connection at the site. This should correspond to what is stated on your connection document from the grid operator. If in doubt, check your connection document or ask your installer.
#### Import limit
The maximum power the site is permitted or desired to draw from the grid, expressed in kW. The EMS uses this value when deciding how and when to charge the battery or manage other controllable loads.
{% hint style="warning" %}
This value must never exceed your contracted **access capacity** with the grid operator. If the site draws more than the import limit continuously for longer than 15 minutes, a peak tariff surcharge from Fluvius may apply.
{% endhint %}
**Where to find your access capacity**: On [mijnfluvius.be](https://mijnfluvius.be) or in your grid connection contract.
**How to determine the right value**: The import limit is the maximum monthly peak you want to draw from the grid. How low you can set this depends on how much local energy (solar, battery) is available. The lower the import limit, the more the EMS will rely on local generation and storage to avoid exceeding it. There is no fixed formula. This value is site-specific and typically determined in consultation with your installer.
#### Export limit
The maximum power that may be injected into the grid from this installation, expressed in kW.
**Where to find it**: In your connection contract with the distribution network operator (DNO). The export limit is often set to the sum of the capacities of local generation sources or to the grid connection capacity. Always verify this against your current connection contract.
#### Import safety margin
A buffer subtracted from the import limit. The EMS uses the resulting value as its effective target when optimising battery charging and other controllable loads:
**Effective import target = Import limit − Safety margin**
**Example**: If your access capacity is 100 kVA and you want to target a monthly peak of 30 kVA, set the import limit to 100 kVA and the safety margin to 70 kVA. The EMS will then aim to keep grid import below 30 kVA when charging the battery or managing loads.
#### Export safety margin
A buffer subtracted from the export limit. This reduces the risk of accidentally exceeding your export capacity. Works in the same way as the import safety margin, but applies to injection.
Voltmasters EMS: grid settings
### Strategy
#### Choosing a strategy
The strategy determines the primary objective of the battery and controllable devices.
| Strategy | Description |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Voltmasters Cost Optimisation** | The EMS buys and sells energy at the most financially favourable times, based on EPEX day-ahead prices and your energy contract. Best suited for dynamic energy contracts. |
| **Self-supply** | The battery is used primarily to maximise self-consumption of locally generated energy (PV). Grid interaction is minimised. |
| **No control** | The EMS does not actively control the battery or other devices. |
Consult your installer if you are unsure which strategy best suits your installation and energy contract.
#### Minimum price difference
The minimum margin between the buy and sell price, in €/MWh, that must exist before the EMS will trade energy via the battery. A common starting value is **€20/MWh**. You can adjust this threshold to make the system more or less active in price-based trading.
#### Grey zone
A small power band around zero within which the EMS does not make control adjustments. This prevents constant small corrections and unnecessary wear on controllable equipment. A common value is **0.5 kW**.
#### Power boost reserve
A percentage of the battery's state of charge (SOC) that is reserved exclusively for supporting DC fast charging. Energy below this reserve level will not be discharged for other strategies. Charging the battery (including for vehicles) is still permitted below this level.
Set this value if part of the battery capacity must always remain available for DC fast charging. Consult your installer for the appropriate value for your specific installation.
#### Battery load balancing strategy
Determines how power is distributed across multiple battery inverters when more than one is present.
| Mode | Description |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Cascade** | Battery inverters are activated one by one as more power is needed. The activation order rotates regularly to spread wear evenly across all units. |
| **Pro Rata** | All batteries operate simultaneously. The required power is distributed proportionally based on each battery's remaining usable capacity (kWh), within the maximum charge and discharge rates of each unit. |
#### Selling via battery injection
When this option is enabled, the EMS is permitted to discharge the battery and inject the stored energy into the grid when the injection price is sufficiently favourable.
Enable this when using the **Cost Optimisation** strategy with a dynamic energy contract, if you want the system to generate revenue by selling stored energy. When disabled, the EMS will not plan or execute injection sales via the battery based on energy prices.
Voltmasters EMS: strategy settings
### Energy contract
#### Contract type
| Type | Description |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Dynamic contract** | Energy prices are settled on the basis of quarter-hour or hourly market prices (EPEX spot). The price moves with the actual market, enabling the EMS to optimise more effectively. |
| **Flexible contract** | Rates are adjusted periodically (for example monthly or quarterly) but remain fixed within that period. |
| **Fixed contract** | The price is agreed in advance for the entire duration of the contract and does not change with the market. |
#### Consumption scaling factor
A multiplier applied to the measured consumption to better approximate your actual billing by your energy supplier. A value of **1** means no correction is applied. If your supplier uses separate day and night tariffs, use the average of both. A common value is **1** or **1.05**.
#### Consumption cost
The cost you pay for energy drawn from the grid, expressed in €/MWh. Find this value in your energy contract or ask your energy supplier.
If you do not know this value, leave the field blank. The EMS will fall back to default values, but this will reduce the accuracy of the cost optimisation calculations.
#### Distribution cost
The total of all grid costs charged per MWh on your electricity bill, expressed in €/MWh. Find this in your energy contract or on your electricity bill.
{% hint style="info" %}
Add up all per-MWh charges on your bill: transport, distribution, taxes, and levies. Do **not** include the monthly or yearly access capacity charge, as this is a fixed charge not calculated per MWh.
{% endhint %}
If unavailable, leave the field blank and the EMS will use default values.
#### Injection scaling factor
A multiplier applied to the measured injection, equivalent in purpose to the consumption scaling factor but for energy injected into the grid. Find this in your energy contract or ask your supplier. Defaults apply if left blank.
#### Injection cost
The net compensation or cost associated with injecting energy into the grid, expressed in €/MWh. This value can be negative during periods of negative market prices. Find this in your energy contract. Defaults apply if left blank.
Voltmasters EMS: energy contract settings
### Grid connection references
Your **EAN number** is the unique identifier for your grid connection point. You can find it on your grid connection contract or on your electricity bill.
If you do not know your EAN number, leave this field blank. It has no effect on EMS operation or optimisation and is used for administrative reference only.
Voltmasters EMS: grid connection references
### Deleting a project
To permanently delete this project, use the **Delete project** option at the bottom of the project settings page.
{% hint style="warning" %}
Deleting a project is permanent and cannot be undone. All associated data, devices, and settings will be removed.
{% endhint %}
Voltmasters EMS: delete project
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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://docs.voltmasters.io/voltmasters-platform/10.-project-settings/10.5-project-settings.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.