Knowledge about archetypes is stored in catalogs.
The catalogs are xml files: see the reference documentation.
The Archetype Plugin comes bundled with an internal catalog. This one is used by default.
The Archetype Plugin can use catalogs from local filesystem and from HTTP connections.
A catalog is an xml file with such content:
<?xml version="1.0" encoding="UTF-8"?> <archetype-catalog xmlns="http://maven.apache.org/plugins/maven-archetype-plugin/archetype-catalog/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/plugins/maven-archetype-plugin/archetype-catalog/1.0.0 http://maven.apache.org/xsd/archetype-catalog-1.0.0.xsd"> <archetypes> <archetype>  <groupId>org.appfuse.archetypes</groupId>  <artifactId>appfuse-basic-jsf</artifactId>  <version>2.0</version>  <repository>http://static.appfuse.org/releases</repository>  <description>AppFuse archetype for creating a web application with Hibernate, Spring and JSF</description> </archetype> ... </archetypes> </archetype-catalog>
During the creation of a project from an archetype, the Archetype Plugin asks the user to choose an archetype from a list containing the archetypes from each of the provided catalogs (yes, there may be many).
For each archetype in the list, the Archetype Plugin shows a line like:
1: internal -> appfuse-basic-jsf (AppFuse archetype for creating a web application with Hibernate, Spring and JSF)
At the end of the create-from-project behaviour, the Archetype Plugin installs/deploys the archetype, and updates the local/remote catalog.
The crawl-repository goal is used to create a catalog file by crawling a Maven repository located in the filesystem.
The Archetype Plugin knows by default about its internal catalog. It also knows about the local and remote catalogs.
local represents the ~/.m2/archetype-catalog.xml catalog file.
remote represents the http://repo.maven.apache.org/maven2/archetype-catalog.xml catalog file.
The Archetype Plugin can also read catalogs from filesystem/HTTP by providing the path/URL of a catalog file or of a directory containing an archetype-catalog.xml file.