IntelliJ IDEA 9/10, what folders to check into (or not check into) source control?

version-control intellij-idea
benstpierre picture benstpierre · Jun 14, 2010 · Viewed 29.1k times · Source

Our team has just moved from Netbeans to IntelliJ 9 Ultimate and need to know what files/folders should typically be excluded from source control as they are not "workstation portable", i.e.: they reference paths that only exist on one user's computer.

As far as I can tell, IntelliJ wants to ignore most of the .idea project including

.idea/artifacts/*
.idea/inspectionProfiles/*
.idea/copyright/*
.idea/dataSources.ids
.idea/dataSources.xml
.idea/workspace.xml

However, it seems to want to check in the .iml files that exist in each module's root directory.

I originally checked in the entire .idea directory via the command line which is obviously not aware of what "should" be ignored by IDEA. Is the entire .idea directory typically ignored?

Answer

CrazyCoder picture CrazyCoder · Jun 15, 2010

We have a FAQ article covering this question.

[The .idea] format is used by all the recent IDE versions by default. Here is what you need to share:

  • All the files under .idea directory in the project root except the workspace.xml and tasks.xml files which store user specific settings
  • All the .iml module files that can be located in different module directories (applies to IntelliJ IDEA)

Be careful about sharing the following:

  • Android artifacts that produce a signed build (will contain keystore passwords)
  • In IDEA 13 and earlier dataSources.ids, datasources.xml can contain database passwords. IDEA 14 solves this problem.

You may consider not to share the following:

  • .iml files for the Gradle or Maven based projects, since these files will be generated on import
  • gradle.xml file, see this discussion
  • user dictionaries folder (to avoid conflicts if other developer has the same name)
  • XML files under .idea/libraries in case they are generated from Gradle or Maven project

.idea directory is a replacement for the old .ipr (Idea Project) file and if you want to share the project between users, then you need to share .idea folder (with the exceptions mentioned in the FAQ) and all the .iml files.

Related questions

How to deal with IntelliJ IDEA project files under Git source control constantly changing?

Everyone on our team uses IntelliJ IDEA, and we find it useful to put its project files (.ipr and .iml) into source control so that we can share build configurations, settings, and inspections. Plus, we can then use those inspection …

Read More
How do I set user.email and user.name in Intellij 14 with GIT integration?

I have IntelliJ 14 with GIT integrated. git push command shows the Author as unknown. How do I set the following two parameters in my IntelliJ IDE? git config --global user.name "Sam Smith" git config --global user.email sam@example.…

Read More
How to clone a project from Bitbucket into Intellij IDEA?

I tried VCS -> Checkout from Version Control -> Bitbucket (Bitbucket plugin). IDE shows the following: Login to Bitbucket ... Getting list of repositories ... That's all. No dialog boxes with a selection of the repository. I would be grateful …

Read More