29 lines
1.7 KiB
Text
29 lines
1.7 KiB
Text
[[_getting_started_overview]]
|
|
== Getting Started
|
|
|
|
Before you can participate in this tutorial, you need to complete the installation of {{book.project.name}} and create the
|
|
initial admin user as shown in the link:{{book.project.doc_base_url}}{{book.project.doc_info_version_url}}{{book.external_link.keycloakinstallingandboot.link}}[{{book.external_link.keycloakinstallingandboot.name}}] tutorial.
|
|
There is one caveat to this. You have to run a separate {{book.appServer}} instance on the same machine as the
|
|
{{book.project.name}} server. This separate instance will run your Java Servlet application. Because of this you will
|
|
have to run the {{book.project.name}} under a different port so that there are no port conflicts when running on the
|
|
same machine. Use the `jboss.socket.binding.port-offset` system property on the command line. The value of this property
|
|
is a number that will be added to the base value of every port opened by the {{book.project.name}} server.
|
|
|
|
To boot the {{book.project.name}} server:
|
|
|
|
.Linux/Unix
|
|
[source]
|
|
----
|
|
$ ${KEYCLOAK_SERVER_DIR}/bin/standalone.sh -Djboss.socket.binding.port-offset=100
|
|
----
|
|
|
|
.Windows
|
|
[source]
|
|
----
|
|
> ${KEYCLOAK_SERVER_DIR}\bin\standalone.bat -Djboss.socket.binding.port-offset=100
|
|
----
|
|
|
|
For more details about how to install and configure a {{book.appServer}}, please follow the steps on the link:{{book.project.doc_base_url}}{{book.project.doc_info_version_url}}{{book.external_link.keycloakinstallclientadapter.link}}[{{book.external_link.keycloakinstallclientadapter.name}}] tutorial.
|
|
|
|
After installing and booting both servers you should be able to access {{book.project.name}} Admin Console at http://localhost:8180/auth/admin/ and also the {{book.appServer}} instance at
|
|
http://localhost:8080.
|