keycloak-scim/authorization_services/topics/getting-started-overview.adoc

[[_getting_started_overview]]
= Getting Started

Before you can use this tutorial, you need to complete the installation of {project_name} and create the initial admin user as shown in the link:{gettingstarted_link}[{gettingstarted_name}] tutorial.
There is one caveat to this. You have to run a separate {appserver_name} instance on the same machine as {project_name} Server. This separate instance will run your Java Servlet application. Because of this you will have to run the {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 {project_name} Server.

To boot {project_name} Server:

ifeval::["{kc_dist}" == "quarkus"]
.Linux/Unix
[source]
----
$ .../bin/kc.sh start-dev --http-port 8180
----

.Windows
[source]
----
> ...\bin\kc.bat start-dev --http-port 8180
----
endif::[]

ifeval::["{kc_dist}" == "wildfly"]
.Linux/Unix
[source]
----
$ .../bin/standalone.sh -Djboss.socket.binding.port-offset=100
----

.Windows
[source]
----
> ...\bin\standalone.bat -Djboss.socket.binding.port-offset=100
----
endif::[]

For more details about how to install and configure a {appserver_name}, please follow the steps on the link:{adapterguide_link}[{adapterguide_name}] tutorial.

After installing and booting both servers you should be able to access {project_name} Admin Console at http://localhost:8180{kc_admins_path}/ and also the {appserver_name} instance at
http://localhost:8080.