feat: add getting started page

Signed-off-by: Christophe Chauvet <christophe.chauvet@gmail.com>

Author: kryskool

.vitepress/config.mts

@@ -44,6 +44,7 @@ export default defineConfig({
         collapsed: false,
         items: [
           { text: 'Overview', link: 'engine' },
+          { text: 'Getting started', link: 'engine/getting_started' },
           { text: 'Contributing', link: 'engine/contributing' },
         ]
       },

docs/engine/getting_started.md

@@ -0,0 +1,171 @@
+# Getting started
+
+To quickly start with Open Integration Engine, also called OIE in this documentation, 
+You can use the different installers available on Windows, Mac OS and Linux platforms.
+
+::: tip INFORMATION
+
+All installers are available at the release page on github, see [Github Release](https://github.com/OpenIntegrationEngine/engine/releases)
+
+The installers are available in 2 flavors:
+
+* With Java Runtime Environment (JRE) 
+* Without JRE
+:::
+
+
+## System requirements
+
+The OIE Server operates as a completely self-contained application and does not depend on any external application server.
+
+### Java requirements
+
+The Open Integration Engine require Java 17+ to work
+
+::: warning
+OIE can work with older versions of Java, but this is not recommended, 
+as some extensions may require version 17 to function correctly.
+:::
+
+### Database requirements
+
+OIE comes with the Derby database by default, which allows you to store configuration and messages, for the purpose of rapid deployment, development and testing.
+
+However, during a production deployment, it is recommended to use one of the following database engines:
+
+* PostgreSQL and above
+* MySQL 8.0 and above
+* MariaDB 10.11 and above
+* Oracle 18c and above
+* SQL Server 2019 and above
+
+## Download and installation
+
+You can download the latest version of Open Integration Engine for your platform at this 
+[address](https://github.com/OpenIntegrationEngine/engine/releases/latest).
+
+
+### Windows
+
+::: info
+Add Screenshots for windows Installation
+:::
+
+### Mac OS
+
+![Mac OS Installer Package](images/gs_macos_installer-package.png "Mac OS Installer Package")
+
+Double-click to launch the Open Integration Engine Installer
+
+![OIE Installer Welcome Screen](images/gs_macos_install_step_1.png "OIE Installer Welcome Screen")
+
+The welcome screen just resume the information, just click on `Next`
+
+![OIE Installer License Screen](images/gs_macos_install_step_2.png "OIE Installer License Screen")
+
+This screen display the license, to continue you must accept this licence by check `I accept the agrement`
+and after click on `Next`
+
+![](images/gs_macos_install_step_3.png)
+
+Read this screen informations and click on `Next`to continue.
+
+![](images/gs_macos_install_step_4.png)
+
+You can choose another folder if you do not want to install as global package.
+
+::: warning
+If you let the default application folder, to launch the oie server, you need to use `sudo`command.
+:::
+
+And click on `Next` to start the installation.
+
+![](images/gs_macos_install_step_5.png)
+
+
+You can display the progress of the installation with this screen
+
+![OIE Installer Summary](images/gs_macos_install_step_6.png "OIE Installer Summary")
+
+This is the final screen of the installer, just click on Finish to close the installer wizard.
+
+Now, open a Terminal and start the OIE server
+
+```shell
+sudo /Applications/OpenIntegrationEngine/oieserver
+```
+
+The first time, the server create the default database, if server is launch correctly, you need to display these lines
+
+```shell
+INFO  2026-01-15 20:07:38.773 [Main Server Thread] com.mirth.connect.server.Mirth: Open Integration Engine 4.5.2 (Built on July 8, 2025) server successfully started.
+INFO  2026-01-15 20:07:38.776 [Main Server Thread] com.mirth.connect.server.Mirth: This product was developed by NextGen Healthcare (https://www.nextgen.com) and its contributors (c)2005-2024.
+INFO  2026-01-15 20:07:38.776 [Main Server Thread] com.mirth.connect.server.Mirth: Open Integration Engine contributors (c)2025.
+INFO  2026-01-15 20:07:38.777 [Main Server Thread] com.mirth.connect.server.Mirth: Running OpenJDK 64-Bit Server VM 17.0.15 on Mac OS X (15.7.3, aarch64), derby, with charset UTF-8.
+INFO  2026-01-15 20:07:38.778 [Main Server Thread] com.mirth.connect.server.Mirth: Web server running at http://192.168.1.X:8080/ and https://192.168.1.X:8443/
+```
+
+::: tip
+Please note these URLs, as we will need them later.
+:::
+
+### Linux
+
+
+## First launch
+
+To verify if the OIE server is availble, open your web browser and enter the URL previously noted.
+
+After confirmed to accept self signed certificate, you will see this page
+
+![OIE Server Welcome Page](images/gs_web_browser_step_1.png "OIE Server Welcome Page")
+
+Copy the Administator Launcher URL
+
+### Ballista
+
+### MCAL
+
+The original Mirth Connect Administrator Launcher works with OIE, you can use it.
+
+Go to the Mac Os Launcher and search Mirth, you will see this icon.
+
+![MCAL MacOS Launcher](images/gs_launcher_mcal.png "MCAL MacOS Launcher")
+
+If it's the first launch, the left panel with connections is empty
+
+![MCAL Connections](images/gs_mcal_step_1.png "MCAL Connections")
+
+To work better with OIE, choose `Bundled Java 17`
+
+And just click on `Launch`at the top right screen.
+
+You should see a progress bar that will load the files necessary to launch the Open Integration Engine client.
+
+![OIE Login Screen](images/gs_oie_login_step_1.png "OIE Login Screen")
+
+::: warning
+
+If you use a new instance, the defaults credentials are:
+
+* login: **admin**
+* password: **admin**
+:::
+
+After enter credential, click on `Login` Button
+
+![](images/gs_oie_login_step_2.png)
+
+After some time, you will see the OIE dashboard.
+
+Now it ask to change the default password
+
+![](images/gs_oie_credential_update_step_1.png)
+
+Fill the information, and don't forget to set the `New Password` ( 2 times)
+
+And click on `Finish`
+
+![](images/gs_oie_dashboard.png)
+
+It's finished, now you can start to use OIE server,