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
| Audience | Why it matters to you |
|---|---|
| All engineers | Required before Lab 1 |
Prerequisites
| Tool | Version | Notes |
|---|---|---|
| JDK | 11 (Oracle/Azul) | AEM 6.5 SP-current supports Java 11 |
| Maven | 3.8+ | With access to the Adobe public repo |
| Node.js | LTS | For the frontend build in the archetype |
| AEM quickstart jar + license | 6.5 + latest Service Pack | From 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)
- Create two folders,
authorandpublish, each with the quickstart jar (renamed as above) andlicense.properties. - Double-click or run
java -jar aem-author-p4502.jar. First start takes several minutes. - Install the latest Service Pack via Package Manager on both instances.
- Log in at
http://localhost:4502with 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
| Check | URL | Expected |
|---|---|---|
| Author up | http://localhost:4502/sites.html | Sites console loads |
| CRXDE | http://localhost:4502/crx/de | Repository tree visible |
| OSGi console | http://localhost:4502/system/console/bundles | Your phi-academy bundles Active |
| Publish up | http://localhost:4503/ | Default page renders |