> For the complete documentation index, see [llms.txt](https://docs.editran.onesait.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.editran.onesait.com/documentacion-editran/connect-3.2-en/instalacion/windows_inicio.md).

# Deployment on Windows

This guide will help you with the steps needed to run the application for the first time **Editran Connect** after it has been correctly installed on a Windows system.

***

> ⚠️ About this process: if you are coming from Connect 2.1.x versions or earlier Connect versions, the migration process requires an update to regenerate the core .cfg files. You can continue the process in [Migration](/documentacion-editran/connect-3.2-en/migracion/clasico-a-connect.md).

## Prerequisites

* The installation has completed without errors and **Editran Connect** is correctly installed. You can verify it from the Windows Control Panel.
* The necessary services are correctly installed. You can verify it from the Windows Services panel.
* Check, from the Windows Services panel, that the services required for the initial execution of **Editran Connect** are running:
  * Editran Connect Base
  * Editran Connect Data
  * Editran Connect Server
  * Editran Connect Sign

***

## Step 1: License

> ⚠️ Skip this step if you already have a valid license file.

**Editran Connect** requires a specific license for each computer to function, depending on a *HostID* (unique code for each machine where Editran is installed).

1. Generate the file with the *HostID*. You can do it in either of the following two ways:
   * Running the file `license.bat` from the command line, and which is located in the folder `\core\bin` of the installation of **Editran Connect**.
   * Running the shortcut *License* that is found in the application programs group, within the Start menu, and that was created during installation.

     ![Programs group](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-3a36014c8a3cd28660417440bcec8c83ad36e521%2Fgrupo_de_programas.png?alt=media)
2. You must send the generated file in an email to the support team so they can generate your personalized license.
3. When the support team has the new generated license, you will receive an email with an attachment that you must download.
4. It is the responsibility of the administrator of **Editran Connect** to protect this file so that it cannot be modified, as that would cause the system to stop working.

***

## Step 2: Copy the license file

> ⚠️ Skip this step if you already specified the license file during installation.

1. The file must be copied into the folder `\core\bin\SL` of the installation of **Editran Connect**, with the name `licencia.dat`. If it does not exist, the system will not work correctly.
2. Restart the service *Editran License Service* from the Windows Services panel (`Win + R` → `services.msc` → Enter). If it is not restarted, the service will not work correctly.

   ![Editran License Service](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-e6a232f9123ec35488e1916e12476c1610297d07%2Feditran_servicio_licencia.png?alt=media)

***

## Step 3: Start

Next, you can start the application in the following ways:

* Open a web browser and enter the URL `https://localhost:443/` or `https://<your_domain>:443/`.
* Or, run the shortcut *Editran Connect Web* that is found in the application programs group, within the Start menu, and that was created during installation.
* If this is the first time you access it, the browser may warn you about an invalid certificate. Accept the certificate to continue.

If you have the graphical interface installed:

* Run the shortcut *Editran Connect* located in the application programs group, within the Start menu.4
* You can also use the shortcut that was created on the desktop during installation.

![Programs group](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-3a36014c8a3cd28660417440bcec8c83ad36e521%2Fgrupo_de_programas.png?alt=media)

***

## Step 4: Application registration

Once the application has started, a screen will be shown for entering the application registration data:

![Registration data](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-9142e583c1feeb06bee023d5164dd6c62fd0e1f1%2Fdatos_registro.png?alt=media)

* **First name**: User's first name.
* **Last name**: User's last name.
* **Company**: Company name.
* **NIF**: User's tax ID number (optional).

Click **Continue** to continue with registration.

***

## Step 5: License validation

On this screen, you must enter the activation code provided by the support team.

![License validation](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-205baf7d4b7acf3c715948207ef44a71a8acd2c3%2Fvalidacion_licencia.png?alt=media)

Click **Verify** to check the activation code. If the code is incorrect, the license file does not exist, or it is not valid, an error message will be shown. In this case, verify that the license file is valid and has been copied to the folder `\core\bin\SL`, also check that the service *Editran License Service* is running.

***

## Step 6: Access data

Once the license is validated, you will be asked to enter the access credentials of the first user of the application. This user will have full access to all the features of **Editran Connect**.

![Access data](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-44cf4a63aee062c6cc55a9c01fc589aaf807b5c9%2Fdatos_de_acceso.png?alt=media)

* **Email**: User's email address to log in to the application.
* **Password**: User's password. It must contain at least 6 characters, one uppercase letter, one lowercase letter, one number, and one special character.
* **Repeat password**: Repeat the password to confirm it.

Click **Finish** to complete the registration. If the password does not meet the requirements, an error message will be shown. In this case, verify that the password meets the established requirements.

***

## Step 7: Enter the application

Next, a screen to access the application will be shown. Enter the email address and password of the user you just created.

![Sign in](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-af602fb0d6dd72c109eb7856ae284d8c33d62448%2Finicio_de_sesion.png?alt=media)

* **Email**: User's email address.
* **Password**: User's password.
* **Remember me**: Check this option if you want the application to remember your password for future logins.

Click **Sign in** to access the application.

***

## Step 8: Application configuration. IP address

Once you have accessed the application, a screen will be shown for entering the local configuration data, specifically the IP address. This configuration is necessary for the application to work correctly.

![Application configuration. IP address](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-2f3bd9d7a25d403a3e2143ef8cdf545359194a95%2Fconfiguracion_aplicacion_direccion_ip.png?alt=media)

This data can be modified through the corresponding option within the *Local configuration* menu of the application.

1. Enter the local IP address and the port.
2. Click **Save** to save the configuration data.

***

## Step 9: Application configuration. Local code

Finally, you must configure the application's local code. To do this, you must access the *Local codes* option in the *Local configuration* menu of the application. This configuration is necessary for the application to work correctly.

![Application configuration. Local code](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-376dcf1dc7b583bac97f4c06bfe5859502279027%2Fconfiguracion_aplicacion_codigo_local.png?alt=media)

1. Click **New local code** to create a new local code.
2. Enter the local code and its description.
3. Click **Save** to save the data of the new local code.
4. Start the service *Editran Base Service* from the Windows Services panel (`Win + R` > `services.msc` → Enter). If it is not started, **Editran Connect** will not work correctly.

   ![Editran Base Service](https://1386330368-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2jqgE5yyM3S58JKHROiz%2Fuploads%2Fgit-blob-0010aa39d09c981a2a770e4485fed4cb1a1691d8%2Feditran_servicio_base.png?alt=media)

> Remember: if you are coming from Connect 2.1.x versions or earlier Connect versions, the migration process requires an update to regenerate the core .cfg files. If this is the case, you must continue the process in [Migration](/documentacion-editran/connect-3.2-en/migracion/clasico-a-connect.md).

***

## Troubleshooting

### 1. The application does not start

If the application does not start, check the following:

* **Services**: Make sure that the services required for the initial execution of **Editran Connect** are correctly installed and running. You can verify this from the Windows Services panel.

For more information about the error, consult the installation log file.

### 2. The services do not start

If the services do not start, check the following:

* **User permissions**: Verify that the user starting the services has the necessary permissions.
* **Dependencies**: Make sure that all necessary services are running. For example, the service *Editran Connect Data* must be started before starting the service *Editran Connect Base*.
* **Port in use**: Confirm that port 443 *(Editran Connect Server)* or 5432 *(Editran Connect Data)* is not being used by another service. You can use tools such as `netstat` to check the ports in use.
* **Firewall**: Check that the Windows Firewall or any other third-party firewall is not blocking the ports used by the services.
* **Database configuration**: Verify that the database is correctly configured and accessible. Make sure that the access credentials are correct and that the database server is running.
* **Software dependencies**: Verify that the *Microsoft Visual C++ redistributable packages* are correctly installed.
* **Software conflicts**: Make sure that there are no other programs or services conflicting with **Editran Connect**. Check that the application **Editran Core Connect** is uninstalled.
* **License**: Verify that the license file (`licencia.dat`) is present and valid. This means that the services *Editran License Service* and *Editran Connect Base* will not start.
* **Local environment**: The service *Editran Connect Base* will not start until a local environment, IP address, and local code are configured.

For more details about possible errors, review the log files.

***

## Log files

Below is a table with the different log files, their description, name, and location.

| **Description**                   | **File(s)**   | **Location**                    |
| --------------------------------- | ------------- | ------------------------------- |
| Startup and service status log    | `*.out, *log` | `%INSTALL_DIR%\services\logs`   |
| Database errors and events log    | `logfile`     | `%INSTALL_DIR%\data`            |
| Application errors and events log | `*.log`       | `%INSTALL_DIR%\logs`            |
| Core module errors and events log | `*.out, *log` | `%INSTALL_DIR%\core\log`        |
| License errors and events log     | `*.log`       | `%INSTALL_DIR%\core\bin\SL\log` |

***

## Services

Below is a table with the different services of the application, their description and the dependencies required to start them.

| **First name**          | **Description**                        | **Dependencies to start** |
| ----------------------- | -------------------------------------- | ------------------------- |
| Editran Connect Base    | Editran Connect services               | Editran Connect Data      |
| Editran Connect Data    | Database service for Editran Connect   |                           |
| Editran Connect Server  | Web server for Editran Connect         |                           |
| Editran Connect Sign    | Signing services for Editran Connect   | Editran Connect Data      |
| Editran Base Service    | EDITRAN protocol for file transmission | Editran License Service   |
| Editran License Service | Handles License V2 API requests        |                           |

***


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.editran.onesait.com/documentacion-editran/connect-3.2-en/instalacion/windows_inicio.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.