> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexagon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Windows Trial with embedded database

> Requirements See for details on software and hardware requirements Windows Operating System This distribution requires an Internet connection the firs

# Requirements 

> [!NOTE]
>
> See [FlexDeploy System Requirements](https://docs.flexagon.com/flexdeploy-11-2-documentation/flexdeploy-system-requirements.md) for details on software and hardware requirements

* Windows Operating System

> [!NOTE]
>
> **This distribution requires an Internet connection the first time that you run it.**
>
> This method of launching FlexDeploy will also download and install PostgreSQL and setup the database connection to it. If that isn't what you want to do, look at a different install guide instead. This is only intended for trial purposes.
>
> Windows user will be used to create PostgreSQL database and will have superuser permissions for that database as well.

# 4 steps to running FlexDeploy with embedded database

**Step 1**. Ensure Java 21 or 17 64 bit is installed on the computer.

**Step 2**. Extract the zip file to the desired location (referred to as "**FlexDeploy Home**" in this document). See example below, where zip was extracted in C:\installs\FlexDeploy folder.

> [!NOTE]
>
> We recommend use of a folder structure without any spaces in the path.

![Image](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590908209.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=b7b57e0c785759b4ef62b3b1af1a4cef)

**Step 3**. Adjust C:\installs\FlexDeploy\apache-tomcat-flexdeploy\bin\setenvoverride.bat to ensure proper JAVA\_HOME is specified.

![image-20250415-202143.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590908203.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=0b48244eec5d57ef16ecde7f0f41cb0d)

**Step 4**. Start tomcat by running the following script. (Double click on it, or run it from a command window)

File - **\<FlexDeploy Home>/StartWithPostgres.bat**

When you run this for first time, it will download & install PostgreSQL database, then create FlexDeploy schema in it. Here are some screen shots to show progress of first execution of StartWithPostgres.bat.

![image-20241010-163411.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590908212.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=98f705d6f67c9a6657e82ae5e00caf01)

You will also see Tomcat process window when Tomcat is started.

![image-20241010-163908.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590908200.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=cf2311475d9840604940adb7d0d0342d)

**Step 5**. FlexDeploy will automatically launch in your default browser ([http://localhost:8000/flexdeploy](http://localhost:8000/flexdeploy)). (It will take about 3-5 minutes the first start due to initial data load)

You will need to complete the [Initial Registration](https://docs.flexagon.com/hidden-fd112/initial-registration.md) process, where you will create admin user for login.

![image-20241010-163830.png](https://mintcdn.com/flexagon-llc-ce77a95c/NkeZh5D-Nf8j_WaD/images/fd111/12590908206.png?fit=max\&auto=format\&n=NkeZh5D-Nf8j_WaD\&q=85\&s=fe4372546b2ff3c4a5c2c14d47f7e090)

**Step 6**. Now that you have installed FlexDeploy, let's get start with configuration. You can do this in matter of minutes by using [Blueprints](https://docs.flexagon.com/flexdeploy-11-2-documentation/flexdeploy-users-guide/blueprints.md) concept, which is very simple configuration wizard for most common use cases.

### If FlexDeploy doesn't appear after a few minutes, here are some troubleshooting tips:

* Logs are located at **\<FlexDeploy Home>/apache-tomcat-flexdeploy/logs**

* Usually opening flexdeploy.0.log is the best way to find the problem. The most common problem is that a port that Tomcat wants to use is already in use.

* By default, the Tomcat server is configured to run on port 8000. If this port is in use, change to some other unused port. Search for **\<Connector port="8000" protocol=" dHTTP/1.1",** if you want to change it...

  * Edit the file at **\<FlexDeploy Home>/apache-tomcat-flexdeploy/conf/server.xml**

  * There are other ports referenced in the server.xml file as well. If the logs contain a port in use error, you can find the open ports on your machine and then search this file for ports that you find are in use and change them.

* If the logs folder doesn't have any useful information, and you aren't sure what else to try, use a command window and go to the bin folder. Then execute the command "catalina.bat run" A better error message should be shown.

* If you still aren't sure what to do, email us at our support site, [support@flexagon.com](mailto:support@flexagon.com)

* If you get any Java related errors, verify that you have Java 21 or 17 64 bit installed. If troubles persist, modify the Tomcat Environment script setenv.bat for JAVA\_HOME.

  * **\<FlexDeploy Home>/apache-tomcat-flexdeploy/bin/setenv.bat**

# Known Issues

If you see issue like below, then proceed to install Microsoft Visual C++ Runtime.

![image-20261019-180553.png](https://mintcdn.com/flexagon-llc-ce77a95c/WGIkb7TtTxAvNbdY/images/fd112/12937035782.png?fit=max\&auto=format\&n=WGIkb7TtTxAvNbdY\&q=85\&s=a505bd939d05d5433fce9a2cfab917f1)
