HomeStart Here › Environment setup (local AEM 6.5)

Environment setup (local AEM 6.5)

Purpose: Get a local AEM 6.5 author instance, a publish instance, and a project skeleton running on your machine.

Who this page is for

AudienceWhy it matters to you
All engineersRequired before Lab 1

Prerequisites

ToolVersionNotes
JDK11 (Oracle/Azul)AEM 6.5 SP-current supports Java 11
Maven3.8+With access to the Adobe public repo
Node.jsLTSFor the frontend build in the archetype
AEM quickstart jar + license6.5 + latest Service PackFrom your organisation's licensed distribution

Author and publish instances

~/aem/author/aem-author-p4502.jar     ~/aem/publish/aem-publish-p4503.jar
        │  first run unpacks & starts        │
        ▼                                    ▼
http://localhost:4502  (author)      http://localhost:4503  (publish)
  1. Create two folders, author and publish, each with the quickstart jar (renamed as above) and license.properties.
  2. Double-click or run java -jar aem-author-p4502.jar. First start takes several minutes.
  3. Install the latest Service Pack via Package Manager on both instances.
  4. Log in at http://localhost:4502 with the admin credentials configured for your local instance.

Run modes are encoded in the jar filename: author/publish and the port. See Run modes.

Project skeleton

Generate a clean project with the official archetype (fictional group/app IDs for the academy):

mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate \
  -D archetypeGroupId=com.adobe.aem \
  -D archetypeArtifactId=aem-project-archetype \
  -D archetypeVersion=39 \
  -D appTitle="PHI Academy" -D appId="phi-academy" \
  -D groupId="com.academy.phi" -D aemVersion="6.5.17"

Build and deploy to your local author:

mvn clean install -PautoInstallSinglePackage

Sanity checks

CheckURLExpected
Author uphttp://localhost:4502/sites.htmlSites console loads
CRXDEhttp://localhost:4502/crx/deRepository tree visible
OSGi consolehttp://localhost:4502/system/console/bundlesYour phi-academy bundles Active
Publish uphttp://localhost:4503/Default page renders

Quick navigation