# CODESYS Installation

{% hint style="info" %}
The CODESYS version currently recommended by us is **3.5.21.2 with our "setup configuration file"**

Our current templates and libraries have been tested with this version. The current CODESYS version is thoroughly tested, and our templates are released for it. Our newsletter keeps you informed about new versions.
{% endhint %}

## Explanation

Specifying the CODESYS version (e.g. 3.5.21.2) alone is not sufficient to ensure an identical, error-free installation on different computers. A CODESYS installation is also affected by numerous add-ons, which can each be available in different versions.

To nevertheless ensure a consistent installation with exactly defined add-on versions, CODESYS provides so-called "setup configuration files".

We provide you with such a setup configuration file for [download](/hub/downloads/en/codesys-hvac-templates/codesys-installation.md) available.

We generally recommend carrying out the CODESYS installation with our latest setup configuration file.

Advantage:\
All our project templates and macros were created with this setup configuration. This means you work in exactly the same environment as our developers.

If you want to use a different CODESYS version or a different configuration, we can only provide limited help with support requests. In such cases, we reserve the right to bill support as a chargeable service.

We continuously monitor the release of new CODESYS versions. When new versions offer useful improvements, we update our templates accordingly and provide a new setup configuration file for download.

Note:\
We recommend not downloading the full installation file directly from the CODESYS Store. Instead, download only the CODESYS Installer and carry out the installation using our setup configuration file.

## Installation instructions

Follow these instructions for a correct CODESYS installation in order to participate in our training courses or use our templates for production projects:

1. Create a CODESYS Store account\
   Go to the CODESYS Store and create a free user account.
2. Download the CODESYS Installer\
   Search for "CODESYS Installer" in the CODESYS Store or use the [download link](https://store.codesys.com/de/codesys-installer.html).

<figure><img src="/files/494343e94505df3c76078b4fe49c67d096418286" alt="" width="375"><figcaption></figcaption></figure>

&#x20;&#x20;

3. Install the CODESYS Installer\
   Start the downloaded installation file and install the CODESYS Installer on your computer.
4. Download the powerIO setup configuration file\
   Go to the [powerIO download area](https://support.powerio.com/hub/downloads/codesys-hvac-templates/codesys-installation) to the section\
   "CODESYS HVAC → CODESYS setup configuration file"\
   and download the latest setup configuration file.
5. Start the CODESYS Installer\
   Start the installed CODESYS Installer.
6. Add new installation\
   Click "Add installation" in the top right corner and then select "Express".

<figure><img src="/files/30d870cbbe58b50b3c1e389ef874d7dd209e4850" alt="" width="375"><figcaption></figcaption></figure>

7. Select setup configuration file\
   Select the setup configuration file you downloaded earlier.
8. Set installation options\
   Assign a name for the installation if needed.\
   If possible, activate the option "Create separate repositories".

<figure><img src="/files/079b8fec5bcaa948a3b84a185139a172500d89bc" alt="" width="354"><figcaption></figcaption></figure>

9. Install add-ons dialog\
   The required add-ons have already been selected by the setup configuration file.\
   Therefore, click "Install" directly.

<figure><img src="/files/a4aa8333fea7dd9aaf0280f276e8f92d5a74c3ac" alt="" width="373"><figcaption></figcaption></figure>

10. Confirm installation\
    Confirm the final security prompt with "Yes" and allow Windows to install it.\
    The installation process usually takes about 20 minutes.

After installation

You can start CODESYS via the Installer by clicking "Start" for the corresponding installation.\
The CODESYS Installer can manage multiple different CODESYS installations in parallel.

**Recommendation**: freeze installation

After successful installation, we recommend setting the installation to "frozen" in the Installer. This prevents add-ons from being updated unintentionally and your development environment from changing unexpectedly.

<figure><img src="/files/c0d81bf7ac31a6948439573a72754fdc2876bc04" alt="" width="322"><figcaption></figcaption></figure>

If you want to test a new CODESYS version, it is advisable to install it in parallel as an additional installation. The frozen installation should not be changed in the production environment. By using the "Create separate repositories" option during installation, the library managers of the different versions do not affect each other. This means that in your production environment, CODESYS also does not suggest any updates to newer libraries that were installed on your computer by the newer CODESYS installation.

Further information about the CODESYS Installer and CODESYS installation can be found in the [CODESYS online help](https://content.helpme-codesys.com/de/CODESYS%20Installer/_inst_start_page.html)


---

# 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://support.powerio.com/hub/codesys-hvac/en/overview/codesys-installation.md?ask=<question>
```

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.