Articles in this section

How can I clear my Maven cache?

Maven is a popular build automation and project management tool used primarily for Java projects. Occasionally, you might encounter situations where cached dependencies or artifacts are causing issues with your project's build process. Clearing the cache in Maven can help resolve these problems. This article provides step-by-step instructions on how to clear the cache in Maven on a local PC.

Removing the Cache Repository

Maven stores its downloaded dependencies and artifacts in a local repository to speed up the build process. If you encounter problems related to cached artifacts, you can remove this cache repository. Here's how to do it:

  1. Open a Terminal Window: On macOS or Linux, launch a terminal window. You can usually find the terminal in the Applications folder or by searching in your system's applications.

  2. Navigate to the Cache Directory: In the terminal, use the cd command to navigate to the directory where Maven's cache repository is stored. By default, this directory is located at ~/.m2/repository/.

  3. Remove the Cache Repository: Once you're in the cache directory, use the rm -rf command followed by the directory path to delete the entire repository. The command should look like this:

    rm -rf ~/.m2/repository/

    Please exercise caution when using the rm -rf command, as it will permanently delete the specified directory and its contents. Make sure you have a backup or are confident in your actions before proceeding.

Running a Clean Build

After clearing the cache repository, you should perform a clean build of your Maven project. This will force Maven to re-download all the necessary dependencies and artifacts.

  1. Navigate to Project Directory: In the terminal, use the cd command to navigate to the directory of the Maven project you want to build.

  2. Run Clean Build Command: To perform a clean build, use the mvn clean install command. This command not only compiles and packages your project but also clears any previously compiled output. If you only want to clean the project without performing a full build, you can use the mvn clean command.

    mvn clean install

    The clean phase removes any compiled output and artifacts from previous builds, while the install phase compiles and packages your project and installs the resulting artifact into the local repository.


Clearing the cache in Maven on a local PC can help resolve issues related to cached dependencies and artifacts. By following the steps outlined in this article, you can remove the cache repository and perform a clean build of your Maven project. This ensures that Maven fetches fresh dependencies and artifacts, potentially resolving build-related problems. Remember to exercise caution when deleting files using terminal commands, and always have backups of critical data to avoid unintentional data loss.

Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.