Repository files navigation

This is the home of the Alfresco SDK. The Alfresco SDK is used by developers to build extensions for the Alfresco Digital Business Platform. It is based onApache Maven, compatible with major IDEs and enablesRapid Application Development (RAD)andTest Driven Development (TDD).

This project is released under theApache License, Version 2.0 license.If you are an Enterprise customer check theSupport section.

• 2025-03: Alfresco SDK 4.11.0 released
• 2025-02: Alfresco SDK 4.11.0-A1 released
• 2024-11: Alfresco SDK 4.10.0 released
• 2024-08: Alfresco SDK 4.9.0 released
• 2024-03: Alfresco SDK 4.8.0 released
• 2023-11: Alfresco SDK 4.7.0 released
• 2023-06: Alfresco SDK 4.6.0 released
• 2022-10: Alfresco SDK 4.5.0 released
• 2022-03: Alfresco SDK 4.4.0 released
• 2021-10: Alfresco SDK 4.3.0 released
• 2021-02: Alfresco SDK 4.2.0 released
• 2019-10: Alfresco SDK 4.1.0 released
• 2019-03: Alfresco SDK 4.0.0 released
• 2019-03: Alfresco SDK 3.1.0 released
• 2017-06-23: Alfresco SDK 3.0.1 released,containing a critical bugfix
• 2017-04-01: Alfresco SDK 3.0.0 released
• 2017-03-27: After years of hard work, countless iterations and gathering feedback, SDK 3.0 has finally been merged into the master branch, ready for release in the coming days
• 2016-02-20: SDK 2.2.0 released to Maven Central. Docs forCommunity,Enterprise,Release notes
• 2015-10-19: SDK 2.1.1 released to Maven Central. Docs forCommunity,Enterprise
• 2015-05-20: SDK 2.1.0 released to Maven Central. Docs forCommunity,Enterprise
• 2014-12-23: SDK 2.0.0 release to Maven Central.Docs,Release Notes
• 2014-08-22: First SNAPSHOT of SDK 2.0.0 in theOSS Sonatype Repository!
• 2014-07: Project fully migrated fromGoogle Code.

Please refer to#635 to fix the Search Services 403 problem.

Since ACS 7.1, Share build pipeline has been refactored, and you now have to specify the internalShare version number, in addition to the version of the image, because they are not the same anymore.

This number can be located in the main pom.xml of the project used to build Share, hence:

• property<alfresco-community-share.version> ofacs-community-packaging (Community)
• property<alfresco-enterprise-share.version>ofacs-packaging (Enterprise)

So, if for example you want to use the community version of7.1.0.1, you can go on acs-community-packaging,open the7.1.0.1 release tag, browse its files, open the pom.xml in the root,then copy the value of<alfresco-community-share.version>.

You'll then need to paste this value inside the SDK property<alfresco.share.version>.

• ACS 6 used to run everything asroot.
• ACS 7 introduced analfresco user, that should've been used after theroot user completed its configurations in the Dockerfile.

Due to a bug, this wasn't working in earlier SDKs, and has been fixed in SDK 4.3.

In order to be retro-compatible with ACS 6, however, the user is specified in the SDK property<alfresco.platform.docker.user>.

Hence, its values (already in place) areroot for ACS 6, andalfresco for ACS 7+.

To prevent writing permission problems when logging with the non-root user,thealfresco.log file has also been moved to a more appropriate location (Tomcat logs instead of Tomcat root).

In Q4 2020, Alfresco Platform has undergone a major structural refactoring.

Depending on the Platform version desired, you might need to use SDK 4.1, 4.3, 4.4, 4.5, 4.6, 4.7, 4.8, 4.9, SDK 4.10 or SDK 4.11.0-A1 instead of SDK 4.11.0.

• For Enterprise and Community versions of 7.x, SDK 4.4 or higher must be used
• For Enterprise versions of 6.0.x, 6.1.x, 6.2.x newer than November 2020, SDK 4.3 must be used
• For Enterprise and Community versions of 6.0.x, 6.1.x, 6.2.x older than November 2020, SDK 4.1 must be used

It's also important to remember that:

• Community Platform versions are built byacs-community-packaging
• Community Docker images are published onDocker Hub
• Enterprise Platform versions are built byacs-packaging
• Enterprise Docker images are published onQuay.io

To get started withAlfresco SDK 4.9.x (latest) visit theAlfresco Documentation.

Report issues (and contribute!)here or join us on theIRC Channel.

If you are an Alfresco Customerplease check theSDK Support statusfor the version you are using. If your version is in Limited or Full Support and you need help, visit theSupport Portal.

• As of version 2.0-beta-1, The Alfresco SDK is released inMaven Central. Previous versions are availablein theAlfresco Artifacts Repository.
• Alfresco (Community and Enterprise) artifacts are hosted in theAlfresco Artifacts Repository.
• Alfresco Community artifacts (JARs, WARs, AMPs, poms) and SDK artifacts are publicly available.

NOTE: By default the Alfresco SDK will use Community Edition releases but it can be configured to use Enterprise Edition releases. Enterprise and Premiercustomers can use the SDK with Enterprise Edition releases by following the process described inWorking with Enterprise.

You can use the following snippet in your pom.xml to access releases from the Alfresco Artifact repository:

<repository>    <id>alfresco-public</id>    <url>https://artifacts.alfresco.com/nexus/content/groups/public</url></repository>

To test new unreleased (unsupported) features, you can use the following snippet in your pom.xml to access SDK nightlies (SNAPSHOTS) from the OSS Sonatype repository:

<repository>    <id>oss-sonatype-snapshots</id>    <url>https://oss.sonatype.org/content/repositories/snapshots/</url></repository>

• Alfresco Community Docker images are publicly available at theAlfresco's Docker Hub profile.
• Alfresco Enterprise Docker images are hosted atQuay.io. Its configuration process is described in detail inHow to configure private Alfresco Docker registry.

See theDevelopers Wiki page.