> For the complete documentation index, see [llms.txt](https://support.powerio.com/hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.powerio.com/hub/codesys-hvac/en/overview/codesys-installation.md).

# CODESYS Installation

Installation of the CODESYS development environment (CODESYS Development System V3) for use with powerIO products.

{% 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 extensively tested, and our templates for it are published. Our newsletter informs you about new versions.
{% endhint %}

## Explanation

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

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

We provide such a setup configuration file for [Download](https://support.powerio.com/hub/downloads/en/codesys-hvac-templates/codesys-installation.md) .

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

Advantage:\
All of 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 for support requests. In such cases, we reserve the right to charge support as a paid service.

We continuously monitor the release of new CODESYS versions. If new versions offer meaningful 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 take part 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 the CODESYS Store for „CODESYS Installer“ or use the [download link](https://store.codesys.com/de/codesys-installer.html).

<figure><img src="https://2592874069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2FRKOu5NYiW0pl4VZyhHMw%2Fimage.png?alt=media&amp;token=134b2573-640e-4713-90c5-117b116153dd" alt="" width="375"><figcaption></figcaption></figure>

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“ at the top right and then select „Express“.

<figure><img src="https://2592874069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2FfJgtFJK2D39g34Cp9fGU%2Fimage.png?alt=media&amp;token=f2750a95-6673-45de-b111-e19531a014fc" alt="" width="375"><figcaption></figcaption></figure>

7. Select the 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, enable the option „Create separate repositories“.

<figure><img src="https://2592874069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2FyiraBkJpqsduFA2KM6qO%2Fimage.png?alt=media&amp;token=3c24fbdb-4095-42ab-ad14-2974976c0da8" alt="" width="354"><figcaption></figcaption></figure>

9. Install add-ons dialog\
   The required add-ons are already selected by the setup configuration file.\
   Therefore, click „Install“ directly.

<figure><img src="https://2592874069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2FNyNs9kXQO0MhXhSbYUyB%2Fimage.png?alt=media&amp;token=4f3d3054-e2da-43f5-bfc2-0d667b5e384c" 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 respective installation.\
The CODESYS Installer can manage several 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 accidentally and your development environment from changing unintentionally.

<figure><img src="https://2592874069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQR4vCFzt6ixgsqlR3pdR%2Fuploads%2FzLPDWQtTU8kOVIiW1sMR%2Fimage.png?alt=media&amp;token=81c119df-9495-4956-9d74-ad6ee318c501" alt="" width="322"><figcaption></figcaption></figure>

If you want to test a new CODESYS version, it is recommended to install it in parallel as an additional installation. The frozen installation should not be changed in the production environment. With the option „Create separate repositories“ during installation, the library managers of the different versions do not affect each other. This means that in your production environment, CODESYS will also not suggest 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
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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://support.powerio.com/hub/codesys-hvac/en/overview/codesys-installation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
