Using the VDOC_HOME property

The VDOC_HOME property is used by the maven plugins to locate the folder containing your instance. This folder will be used to deploy files.

Possibility of creating the VDOC_HOME variable with version 17.1 and earlier

  • windows environment variable
  • environment variable per intellij project
  • maven property per intellij project
  • home.properties file

The properties-maven-plugin takes in order of preference :

  1. maven property per intellij project
  2. environment variable per intellij project
  3. windows environment variable
  4. home.properties file

When using direct goal maven like the sass-watch the home.property is not taken into account because it is only retrieved during the initialize phase

In practice, we quickly find ourselves with a VDOC_HOME environment variable and the home.properties files are no longer taken into account

To avoid confusion, we have decided to remove the use of home.properties files in the following versions

Possibility of creating the VDOC_HOME variable with version 17.2 and following

  • windows environment variable
  • environment variable per intellij project
  • maven property per intellij project

If you need the old properties file you can use the properties-maven-plugin by adding a profile in your pom

Example :

<profiles>
    <profile>
        <id>vdoc-configuration</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <build>
            <plugins>
                <plugin>
                    <groupId>org.codehaus.mojo</groupId>
                    <artifactId>properties-maven-plugin</artifactId>
                    <version>1.0-alpha-2</version>
                    <executions>
                        <execution>
                            <phase>initialize</phase>
                            <goals>
                                <goal>read-project-properties</goal>
                            </goals>
                            <configuration>
                                <files>
                                    <file>home.properties</file>
                                    <file>../home.properties</file>
                                </files>
                                <quiet>true</quiet>
                            </configuration>
                        </execution>
                    </executions>
                </plugin>
            </plugins>
        </build>
    </profile>
</profiles>