Skip to content
javaup documentation

Managing settings.xml

Aliases let you switch between different settings.xml files quickly — a company repository, a public mirror, or an environment with different credentials — without ever replacing the global settings.xml.

Add or Update an Alias

Section titled “Add or Update an Alias”
Terminal window
jup settings add intranet /path/to/settings-intranet.xml
jup settings add public /path/to/settings-public.xml

jup checks that the path is a regular file containing valid XML with <settings> as its root. It stores only the normalized path; it never copies the file or its credentials.

List and Use Aliases

Section titled “List and Use Aliases”
Terminal window
jup settings list
cd /path/to/company-project
jup settings use intranet
jup run mvn clean deploy

The binding belongs to the local project configuration. When Maven starts, jup automatically prepends the corresponding --settings argument.

Unbind or Remove an Alias

Section titled “Unbind or Remove an Alias”
Terminal window
jup settings unset
jup settings remove intranet

unset changes only the current project. remove deletes the global alias. If a removed alias is still referenced by a project, bind another alias or run jup settings unset before the next build.