2016-11-29 15:30:53 +00:00
[[_getting_started_overview]]
2016-06-17 00:14:05 +00:00
== Getting Started
2017-01-20 16:24:58 +00:00
Before you can participate in this tutorial, you need to complete the installation of {{book.project.name}} and create the
2017-03-01 21:19:29 +00:00
initial admin user as shown in the link:{{book.keycloakgettingstarted.link}}[{{book.keycloakgettingstarted.name}}] tutorial.
2017-01-20 16:24:58 +00:00
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.
2016-06-17 00:14:05 +00:00
2017-01-20 16:24:58 +00:00
To boot the {{book.project.name}} server:
2016-06-17 00:14:05 +00:00
2017-01-20 16:24:58 +00:00
.Linux/Unix
[source]
----
$ ${KEYCLOAK_SERVER_DIR}/bin/standalone.sh -Djboss.socket.binding.port-offset=100
----
2016-06-17 00:14:05 +00:00
2017-01-20 16:24:58 +00:00
.Windows
[source]
----
> ${KEYCLOAK_SERVER_DIR}\bin\standalone.bat -Djboss.socket.binding.port-offset=100
----
2016-06-17 00:14:05 +00:00
2017-03-01 21:19:29 +00:00
For more details about how to install and configure a {{book.appServer}}, please follow the steps on the link:{{book.keycloakinstallclientadapter.link}}[{{book.keycloakinstallclientadapter.name}}] tutorial.
2016-06-17 00:14:05 +00:00
2017-01-20 16:24:58 +00:00
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.
