Clone and launch the front-end application - Clone and launch the front-end application - Alfresco - Alfresco Digital Workspace - Alfresco/Alfresco-Digital-Workspace/4.2/Alfresco-Digital-Workspace/Alfresco-Digital-Workspace/Develop/Manage-Digital-Workspace/Clone-and-launch-the-front-end-application - 4.2

Alfresco Digital Workspace

Platform
Alfresco
Product
Alfresco Digital Workspace
Release
4.2
ft:lastPublication
2026-05-06T17:28:51.867000
ft:locale
en-US
ArchiveStatus
Archived

Once Content Services is up and running, you must make the source code of the project available locally in your development environment. If you're an Alfresco customer or partner, you can get a local copy of the project by opening a request in Hyland Community.

  1. In the alfresco-apps directory, create a file named .env with the following content.

    Enter the Content Services URL as the APP_CONFIG_ECM_HOST value.

    ACA_BRANCH="2.10.0"
    BASE_URL="http://localhost:8080"
    APP_CONFIG_ECM_HOST="http://localhost:8080"
    APP_CONFIG_PROVIDER="ECM"
    APP_CONFIG_AUTH_TYPE="BASIC"
    APP_CONFIG_PLUGIN_AOS=false
    APP_CONFIG_PLUGIN_CONTENT_SERVICE=true
    APP_CONFIG_PLUGIN_PROCESS_SERVICE=false
    APP_CONFIG_PLUGIN_AI_SERVICE=false
    

    Note

    The Digital Workspace 4.2.x uses the Content Application version 4.0.0.

  2. Run the following commands to start the application:

    npm ci
    npm start content-ee
    

    The application is available at http://localhost:4200. Use the Content Services credentials to log in.

    The configuration provided for the sample above is the minimal required for your development environment to locally test the Alfresco Repository, but additional environment variables are available.

    # App config settings
    APP_CONFIG_BPM_HOST="<url>"
    APP_CONFIG_ECM_HOST="<url>"
    APP_CONFIG_OAUTH2_HOST="<url>"
    APP_CONFIG_IDENTITY_HOST="<url>"
    APP_CONFIG_PROVIDER="ALL"
    APP_CONFIG_AUTH_TYPE="OAUTH"
    APP_CONFIG_OAUTH2_CLIENTID="alfresco"
    APP_CONFIG_OAUTH2_IMPLICIT_FLOW=true
    APP_CONFIG_OAUTH2_SILENT_LOGIN=true
    APP_CONFIG_OAUTH2_REDIRECT_SILENT_IFRAME_URI="{protocol}//{hostname}/assets/silent-refresh.html"
    APP_CONFIG_OAUTH2_REDIRECT_LOGIN=/
    APP_CONFIG_OAUTH2_REDIRECT_LOGOUT=/
    APP_CONFIG_APPS_DEPLOYED="[{"name": "simpleapp"}]"
    APP_CONFIG_LANDING_PAGE="/personal-files"
    
    # CONTENT RELATED
    ACA_BRANCH="develop"
    APP_CONFIG_PLUGIN_PROCESS_SERVICE=true
    APP_CONFIG_PLUGIN_AI_SERVICE=true
    APP_CONFIG_PLUGIN_AOS=true
    APP_CONFIG_PLUGIN_CONTENT_SERVICE=true
    APP_CONFIG_CUSTOM_MODELED_EXTENSION = "{}"
    
    # CONTENT - MICROSOFT PLUGIN RELATED
    APP_CONFIG_PLUGIN_MICROSOFT_ONLINE=true
    APP_CONFIG_MICROSOFT_ONLINE_OOI_URL="<url>"
    APP_CONFIG_MICROSOFT_ONLINE_CLIENTID="<clientid>"
    APP_CONFIG_MICROSOFT_ONLINE_AUTHORITY="<url>"
    APP_CONFIG_MICROSOFT_ONLINE_REDIRECT="<url>"
    
    # CONTENT - MICROSOFT INTEGRATION TEST RELATED
    MICROSOFT_USER_INITIALS="<user-initials>"
    MICROSOFT_EMAIL="<email>"
    MICROSOFT_USER2_INITIALS="<user-initials>"
    MICROSOFT_EMAIL2="<email>"
    MICROSOFT_PASSWORD="<password>"
    MOO_LOGIN_URL="<url>"