39 lines
2.0 KiB
Markdown
39 lines
2.0 KiB
Markdown
# Environment Transfer Guide
|
|
|
|
To transfer the development environment for this application to another PC, you need to install a few key technologies based on the project's configuration (JHipster 9.1.0, Spring Boot monolith).
|
|
|
|
Here is the complete list of tools and dependencies you need to install on the new PC:
|
|
|
|
## 1. Required Technologies
|
|
* **Java Development Kit (JDK):** **Version 21** (The project is configured with `sourceCompatibility=21` in `build.gradle`).
|
|
* **Node.js:** **Version >= 24.16.0** (Required for JHipster frontend tooling and code formatting, as specified in `package.json`).
|
|
* **NPM:** Comes bundled with Node.js.
|
|
* **Git:** To clone and transfer your source code.
|
|
|
|
## 2. Automatically Managed Dependencies (No installation required)
|
|
* **Gradle:** You do **not** need to install Gradle manually. The project uses the Gradle Wrapper (`gradlew`). Running it will automatically download the correct version for you.
|
|
* **Database (Development):** The `dev` profile uses an **H2 in-memory/file-based database**. You do not need to install an external database to run the project locally.
|
|
* *(Note: The `prod` profile uses an Oracle Database, which is only necessary if you are running it in production mode).*
|
|
|
|
## 3. Recommended Tools (Optional)
|
|
* **IDE:** IntelliJ IDEA, Eclipse, or Visual Studio Code with the Java Extension Pack.
|
|
* **Docker Desktop:** Useful if you want to run additional services (like SonarQube or JHipster Control Center) via the `docker-compose` files located in `src/main/docker/`.
|
|
|
|
---
|
|
|
|
## How to start the project on the new PC
|
|
Once you've installed **Java 21** and **Node.js >= 24.16.0**, you can transfer your code to the new PC and run the following commands in your project's root folder:
|
|
|
|
### 1. Install Node dependencies
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
### 2. Start the development server
|
|
```bash
|
|
./gradlew
|
|
```
|
|
*(On Windows Command Prompt or PowerShell, use `.\gradlew` instead).*
|
|
|
|
This will download all necessary Java dependencies via Gradle and start the application on `http://localhost:8080`.
|