Customize the Enterprise App Store on Self-hosted Installations

Some additional Enterprise App Store settings can be customized for self-hosted installations in order to make them more tailored to your users.

You can change how your store looks using the Customize screen in the Enterprise App Store module, just like you can with Appcircle Cloud.

For self-hosted specific settings, you should follow the documentation below.

Tab Title Localization

You can change the Enterprise App Store tab title according to the language selected on the self-hosted Appcircle server.

For example, you can set a title for TR and a different title for EN language selection on browsers.

info

Appcircle server version 3.12.1 or later is required for this feature.

caution

Be aware that this will cause a downtime on the Appcircle server.

If you set titles from global.yaml by following the steps below, your title settings configured from the Enterprise App Store's "Customize" page will be overridden.

• Log in to Appcircle server with SSH or remote connection.

• Go to the appcircle-server directory.

cd appcircle-server

info

The spacetech in the example codes below are example project name.

Please find your own project name and replace spacetech with your project name.

To see projects, you can check the projects directory.

ls -l ./projects

• Shutdown Appcircle server.

./ac-self-hosted.sh -n "spacetech" down

• Edit the global.yaml file of your project.

vi ./projects/spacetech/global.yaml

• Add the lang parameter to the storeWeb entry.

caution

The storeWeb key should already have been in the global.yaml file.

You just need to add the lang key and other sub-keys to that section.

The global.yaml should have only one storeWeb key for proper working.

storeWeb:
  external:
    subdomain: store
  customDomain:
    enabled: true
    domain: store.spacetech.com
  lang:
    TR_STORE_TITLE: Uygulama Mağazası
    EN_STORE_TITLE: App Store

• Apply configuration changes.

./ac-self-hosted.sh -n "spacetech" export

• Start Appcircle server.

./ac-self-hosted.sh -n "spacetech" up

tip

You should check the status of the Appcircle server after boot for any possible errors.

./ac-self-hosted.sh -n "spacetech" check

You should see the message: "All services are running successfully."

To see the new configuration updates on the store, follow the steps below:

• Go to the Enterprise App Store page of your organization with a browser.

  • For example, store.spacetech.com

• Check the tab title. For our sample configuration,

  • If the language is TR selected, then you should see "Uygulama Mağazası" in the tab title.
  • If the language is EN selected, then you should see "App Store" in the tab title.

Placeholder Text Customization

You can change the placeholder texts for the Enterprise Portal username and password based on the language selected in the language options.

For example, you can set a placeholder text for TR and a different placeholder text for the EN and DE language selections on browsers.

info

Appcircle server version 3.12.1 or later is required for this feature.

caution

Be aware that this will cause a downtime on the Appcircle server.

• Log in to Appcircle server with SSH or remote connection.

• Go to the appcircle-server directory.

cd appcircle-server

info

The spacetech in the example codes below are example project name.

Please find your own project name and replace spacetech with your project name.

To see projects, you can check the projects directory.

ls -l ./projects

• Shutdown Appcircle server.

./ac-self-hosted.sh -n "spacetech" down

• Edit the global.yaml file of your project.

vi ./projects/spacetech/global.yaml

• Add the lang parameter to the storeWeb entry if it doesn't exist.

caution

The storeWeb key should already have been in the global.yaml file.

You just need to add the lang key and other sub-keys to that section.

The global.yaml should have only one storeWeb key for proper working.

• Add the placeholder texts to the lang parameter.

tip

You can specify only for the languages you want to customize.

storeWeb:
  external:
    subdomain: store
  customDomain:
    enabled: true
    domain: store.spacetech.com
  lang:
    TR_LDAP_USERNAME: LDAP kullanıcı adınız
    TR_LDAP_PASSWORD: LDAP şifreniz
    EN_LDAP_USERNAME: LDAP username
    EN_LDAP_PASSWORD: LDAP password
    DE_LDAP_USERNAME: LDAP-gebruikersnaam
    DE_LDAP_PASSWORD: LDAP-wachtwoord

• Apply configuration changes.

./ac-self-hosted.sh -n "spacetech" export

• Start Appcircle server.

./ac-self-hosted.sh -n "spacetech" up

tip

You should check the status of the Appcircle server after boot for any possible errors.

./ac-self-hosted.sh -n "spacetech" check

You should see the message: "All services are running successfully."

To see the new configuration updates on the store, follow the steps below:

• Go to the Enterprise App Store page of your organization with a browser.

  • For example, store.spacetech.com

• Check the placeholder texts. For our sample configuration,

  • If the language is TR selected, then you should see "LDAP kullanıcı adınız" in the username placeholder text.
  • If the language is EN selected, then you should see "LDAP username" in the username placeholder text.
  • If the language is DE selected, then you should see "LDAP-gebruikersnaam" in the username placeholder text.