Skip to content

Setting Up My Account in a Development Environment


The User Portal application has been renamed as My Account from this release onwards.

In WSO2 Identity Server(WSO2 IS), My Account can be accessed via the URL http(s)://<SERVER_HOST>/t/<TENANT_DOMAIN>/myaccount.

Follow the steps given below to set up the repo in a development environment.

Before you begin

  1. Install node if you have not already installed it. Npm is already bundled with node.
  2. Install maven. This is needed to run mvn commands.
  3. A running instance of WSO2 IS. To build from source, follow the instructions given here.

Step 1: Configure WSO2 Identity Server


The default dev origin, hostname, and port that is set for My Account is https://localhost:9000. Change this in the following configurations if you have changed this port or any other configuration.

  1. Enable cross-origin requests for WSO2 Identity Server.

    Cross-origin requests are blocked by default in WSO2 IS as a security measure. Add the following CORS configuration to the <IS_HOME>/repository/resources/conf/deployment.toml file to enable it.

    allow_generic_http_requests = true
    allow_any_origin = false
    allowed_origins = [
    allow_subdomains = false
    supported_methods = [
    support_any_header = true
    supported_headers = []
    exposed_headers = [Location]
    supports_credentials = true
    max_age = 3600
    tag_requests = false
  2. Allowlist your hostname and port as a trusted FIDO2 origin by adding the dev url as an allowed origin in the <IS_HOME>/repository/resources/conf/deployment.toml file.

  3. Make the callback URL configurable by adding the following configuration to the <IS_HOME>/repository/conf/deployment.toml file.

    read_only_apps = []
  4. Restart WSO2 IS.

  5. Configure the callback URLs for My Account.

    1. Log in to the WSO2 IS management console.
    2. Click Service Providers > List.
    3. Click Edit to edit the My Account service provider.
    4. Expand Inbound Authentication Configuration, and then expand OAuth/OpenID Connect Configuration. Click Edit.
    5. Change the Callback URL field to reflect the port as 9000 or you can add a regexp as follows.

Step 2: Build the Identity Apps repository

Fork the original repository to start working on it. You can also directly clone the original repo but it is recommended to create your own fork.

git clone
cd identity-apps
mvn clean install or npm run build

Step 3: Run My Account in dev mode

After the build is complete, navigate to the My Account directory and run the portal using the webpack dev server.

cd apps/user-portal
npm start

The portal will be served from https://localhost:9000/myaccount