An Apache Archiva image for simple standalone deployments.
Tag | Description |
---|---|
v2 ,v2.2.10 , latest |
Tracks the latest version of Archiva |
v3-snapshot |
Tracks v3 snapshot builds for Archiva |
2.2.3 ,v2-legacy |
Legacy versions of this image |
See the Change Log for recent changes!
Getting Help:
Please file issues in the github repository if you find a problem with this image. For general help with Archiva, use the Official Resources
Contributing:
Pull requests/code copying are welcome! See the Contributing documentation for general guidelines.
License:
This image, and Apache Archiva, are covered under the Apache 2.0 License
Apache Archiva is maven-compatible artifact repository that is reasonably configurable and quite stable.
xetusoss/archiva
This goal of this image is to be the easiest way to deploy a simple and reliable version of Apache Archiva. The key features of this image are:
/archiva-data
)https
proxy supportjetty.xml
configuration (which can be overwritten)HEALTHCHECK
feature)There are several ways to deploy an Apache Archiva environment with this image. The simplest is to just start it up via the command line.
docker
commanddocker run --name archiva -p 8080:8080 xetusoss/archiva
docker-compose
The example below shows how to deploy archiva with a separate data volume using docker-compose.
version: '3.4'
services:
archiva:
image: xetusoss/archiva:latest
volumes:
- type: volume
source: archiva-data-vol
target: /archiva-data
environment:
SMTP_HOST: your-smtp-server
volumes:
archiva-data-vol:
For a more complete example of using docker-compose using ngnix as an https proxy, see docker-compose.nginx-https.yaml
The easiest way to deploy this image in Kubernetes is to use the associated helm chart, xetusoss-archiva. See the chart documentation for usage.
SMTP_HOST
, SMTP_PORT
Archiva requires access to an SMTP server for things like password reset emails. These variables are used by the managed jetty.xml
configuration.
SMTP_PORT
has a default value of 25.
Note, there is no authentication support for SMTP in the auto-generated jetty.xml
PROXY_BASE_URL
It is recommended to deploy Archiva behind an HTTPS proxy. When using an HTTPS proxy, Archiva needs to be aware of the proxy's frontend url to operate properly.
Setting PROXY_BASE_URL
will cause the container's entrypoint script to set all the needed java properties for Archiva to be aware of the proxy.
DB_TYPE
, DB_USER
, DB_PASSWORD
, DB_HOST
, DB_PORT
, DB_NAME
, MYSQL_JDBC_PARAMS
The archiva user database can be stored in mysql
instead of derby
(the default). These environment variables can be used to configure the auto-generated jetty.xml
to use a MySQL datasource. They are not necessary when using the default derby
database.
See the docker-compose.mysql.yaml for a complete example of using MySQL.
JVM_EXTRA_OPTS
, MALLOC_ARENA_MAX
Allow fine-tuned control over the JVM environment that archiva runs in, or set the MALLOC_ARENA_MAX. Unless you have specific needs, neither of these need to be set.
JETTY_CONFIG_PATH
If the container-managed jetty.xml
file is not flexible enough for your deployment scenario, the JETTY_CONFIG_PATH
environment variable can be used to manually specify a configuration file.
If custom CA certificates are required, they can be automatically loaded into the java environment by mounting them in the /certs
directory. All certificates must have a .crt
or .pem
extension.
The Archiva project is not dead, but it's development is (very) slow. A reasonable question to ask is "Why bother when there are other tools, like Artifactory?". We don't have a clear-cut answer for that, but here are some of the reasons you might consider Archiva.