archiva-docs/src/site/apt/adminguide/configuration-files.apt

 ------
 Configuration Files of Apache Archiva
 ------

Configuration Files of Apache Archiva

  While Archiva is primarily configured via the graphical administration interface, it stores all configuration in XML configuration
  files that can be hand edited and used for backup and migration.

  The following files compose the configuration for Archiva:

    * <<<archiva.xml>>> - this is the primary Archiva configuration file

    * <<<security.properties>>> - this configures the security as described in the {{{security.html} security configuration documentation}}

  This section will focus on the <<<archiva.xml>>> file.

* The Archiva configuration file

  The Archiva configuration file is stored in one of two locations:

    * The application server configuration directory (see {{{standalone.html} installing Archiva standalone}} for more information)

    * The user home directory (<<<~/.m2/archiva.xml>>>). 

    []

  When modified in the GUI, the file is written back to the location it was initially read from, with the home directory taking priority if both exist. When using a
  standalone installation, it is highly recommended that a configuration file is only maintained in one of the locations.

  The following shows a basic configuration file:

----
<configuration>
  <version>2</version>
  <managedRepositories>
    <managedRepository>
      <location>${appserver.base}/repositories/internal</location>
      <daysOlder>30</daysOlder>
      <id>internal</id>
      <name>Archiva Managed Internal Repository</name>
    </managedRepository>
  </managedRepositories>
  <remoteRepositories>
    <remoteRepository>
      <url>http://repo1.maven.org/maven2</url>
      <id>central</id>
      <name>Central Repository</name>
    </remoteRepository>
  </remoteRepositories>
  <proxyConnectors>
    <proxyConnector>
      <sourceRepoId>internal</sourceRepoId>
      <targetRepoId>central</targetRepoId>
      <policies>
        <releases>always</releases>
        <checksum>fix</checksum>
        <snapshots>never</snapshots>
        <cache-failures>no</cache-failures>
      </policies>
    </proxyConnector>
  </proxyConnectors>
</configuration>
----

  ~~TODO: need a full reference