First of all, create an empty directory in which you will create your application:
Go to that directory:
To generate your application, type:
And answer the questions asked by the generator to create an application taylored to your needs. Those options are described in the next section.
Once the application is generated, you can launch the Java server within your IDE, by running the Application class at the root of your application's Java package.
As it is a simple "Main" class, it is the easiest and quickest way to run and debug the application.
If you prefer to use Maven, you can also run your application by typing:
(this will run our default Maven task,
If you prefer to use Gradle, you can also run your application by typing:
(this will run our default Gradle task,
The application will be available on http://localhost:8080
This is the name of your application.
Your Java application will use this as its root package.
Depending on your choice, JHipster will either create a Java 7 or a Java 8 application. We recommend Java 8 as Java 7 has been end-of-life'd and Java 8 comes with many new features, including lambdas, and having JHipster create some sample code is a great way to start using them.
You can either use a classical session-based authentication mechanism, like we are used to do in Java (this is how most people use Spring Security), a OAuth 2.0 authentication mechanism (JHipster then provides the necessary OAuth2 server code and database tables), or a token-based approach (similar to OAuth 2.0, but uses a custom token system that does not require database tables). The OAuth 2.0 and the token approaches allow to use a stateless application architecture (they do not rely on the HTTP Session). You can find more information on our securing your application page.
This is the database you will use with your "production" profile. To configure it, please modify your
If you want to use Oracle, you will need to install the Oracle JDBC driver manually.
This is the database you will use with your "development" profile. To configure it, please modify your
Hibernate is the JPA provider used by JHipster. For performance reasons, we highly recommend you to use a cache, and to tune it according to your application's needs.
If you choose to do so, you can use either ehcache (local cache) or Hazelcast (distributed cache, for use in a clustered environnement)
By default, JHipster uses a HTTP session only for storing Spring Security's authentication and autorisations information. Of course, you can choose to put more data in your HTTP sessions.
Using HTTP sessions will cause issues if you are running in a cluster, especially if you don't use a load balancer with "sticky sessions".
If you want to replicate your sessions inside your cluster, choose this option to have Hazelcast configured.
Websockets can be enabled using Spring Websocket. We also provide a complete sample to show you how to use the framework efficiently.
By default JHipster provides excellent internationalization support, both on the client side with Angular Translate and on the server side. However, internationalization adds a little overhead, and is a little bit more complex to manage, so you can choose not to install this feature.