Account Management API is now deprecated and we recommend that you use Account Management functionality built into Elastic Path Commerce 8.2 and later.
The Account Management release package consists of a Docker Compose file that builds and deploys Account Management locally for testing or investigation purposes.
The Docker Compose deployment also includes Keycloak, MySQL, email, and web mail containers that provide a complete Account Management experience. Keycloak is an open source identity provider that is compatible with OpenID Connect.
Elastic Path Commerce applications are not included in the Docker Compose deployment. For more information on how to deploy Elastic Path Commerce see Elastic Path documentation. For Account Management specific changes see the Update Elastic Path Commerce section.
- Ensure that Docker is installed
Download the Account Management release package from Elastic Path Nexus.
For more information about the deployment prerequisites, see prerequisites.
Unzip the package.
In the terminal, navigate to the unarchived directory.
docker-compose upcommand. Ensure that all the Docker images are built and all containers are deployed.
After the initialization completes, you can access the Account Management user interface, Account Management API Studio and Keycloak from your browser. For details on default addresses and credentials, see the Accessing the Account Management Service section.
The Docker Compose file creates a Docker volume where data is persisted. For information on how to teardown the Account Management stack with or without the persisted data, see docker-compose down.
Accessing the Account Management Service
|Account Management User Interfacefirstname.lastname@example.org||password|
|Account Management API Studioemail@example.com||password|
|Webmail||Any valid email address||Any non-empty string|
The webmail service uses the virtual email service, Greenmail, that acts as a fully functional SMTP and IMAP service. You can use this service to login and view all emails that are sent by any of the constituent systems, which are stored locally.
Creating associates in Keycloak
By default, the local deployment package only has a seller administrator configured. Use this procedure to create associates in the deployment.
- Log in to Keycloak using the location and credentials.
- In the Master drop down menu, click Commerce. For more information about realms, see the Keycloak Manual Chapter 3 -- The Master Realm section.
- Create a new user following the instructions at Keycloak Manual Chapter 4 - Creating New Users.
By default, the local deployment of Keycloak automatically assigns associate role to the new users. For more information about the implementation, see the