Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<h2>Installation from Download</h2>

<h4>Prerequisites</h4>

<p>In order to start using Griffon you need to have the following:</p>
<ul>
	<li>An installation of Java SDK 1.5 or higher and have set your JAVA_HOME variable to the SDK install location.  Java 1.6 is strongly recommended.</li>
</ul>

<h4>Steps</h4>

<ol>
	<li><a class="confluence-link" href="/display/GROOVY/Download+Griffon" data-linked-resource-id="102105824" data-linked-resource-type="page" data-linked-resource-default-alias="Download Griffon" data-base-url="http://docs.codehaus.org">Download</a> the latest Griffon release</li>
	<li>Extract the archive into an appropriate location; typically C:\griffon on Windows or ~/griffon on Unix</li>
	<li>Create a GRIFFON_HOME environment variable that points to the path where you extracted the archive (eg C:\griffon on Windows or ~/griffon on Unix)</li>
	<li>If you have not set the JAVA_HOME environment variable yet, create JAVA_HOME environment variable that points to the path where you have installed Java</li>
	<li>Append a reference to the &quot;bin&quot; directory within the Griffon directory to your PATH variable (eg %GRIFFON_HOME%\bin on Windows or $GRIFFON_HOME/bin on Unix). Note that, for Windows, both PATH and GRIFFON_HOME must be defined at the same environment variable level (eg. 'System variables') rather than across environment variable levels (eg. PATH under 'System variables' and GRIFFON_HOME under 'User variables')</li>
	<li>Type &quot;griffon&quot; at the command line, if a help message is displayed you are ready to <a class="confluence-link" href="/display/GROOVY/Griffon+Quick+Start" data-linked-resource-id="102105216" data-linked-resource-type="page" data-linked-resource-default-alias="Griffon Quick Start" data-base-url="http://docs.codehaus.org">start using Griffon</a>!</li>
	<li>If you get an error message, try to chmod +x the griffon script inside the bin directory.</li>
</ol>

<h2>Installation from Subversion</h2>

<h4>Prerequisites</h4>

<p>In order to start using Griffon from SVN you need to have the following:</p>
<ul>
	<li>An installation of Java 1.5 or higher and have set your JAVA_HOME variable to the install location</li>
	<li>A working installation of <a href="http://ant.apache.org">Apache Ant</a> 1.6.5 or higher and have set your ANT_HOME variable to the install location</li>
	<li>JUnit (to run the build tests - put junit.jar in your ANT_HOME\lib directory)</li>
	<li>An installation of <a href="http://subversion.tigris.org/">Subversion</a></li>
</ul>

<h4>Steps</h4>

<ol>
	<li>Checkout Griffon from the Griffon Module in the <a href="http://xircles.codehaus.org/projects/griffon/repo/primary/repo">Griffon SVN repository</a>
	<ol>
		<li>Go into an empty directory where you will keep your griffon sources, create one if you want</li>
		<li>Run this command: <code>svn co <a class="external-link" href="http://svn.codehaus.org/griffon/core/trunk" rel="nofollow">http://svn.codehaus.org/griffon/core/trunk</a> griffon-src</code></li>
	</ol>
	</li>
	<li>A subdirectory named <code>griffon-src</code> will be created, let's call that location GRIFFON_SRC</li>
	<li>Go into GRIFFON_SRC</li>
	<li>Make sure you can run ant : <code>ant -version</code>
	<ol>
		<li>If you have an error, try using the ant provided in the sources (you may need to give the ant script executable permission before): <code>./ant/bin/ant -version</code></li>
	</ol>
	</li>
	<li>Decide of a directory where you want griffon to be installed; typically C:\griffon on Windows or ~/griffon on Unix</li>
	<li>Set the GRIFFON_HOME environment variable to that location (make sure it is not below the checkout location)</li>
	<li>Install griffon by running &quot;ant install&quot;</li>
	<li>Once the build runs with success, follow the instructions as if you've downloaded a binary distribution (see &quot;Installation from Download&quot; above).</li>
	<li>That's it! <a class="confluence-link" href="/display/GROOVY/Griffon+Quick+Start" data-linked-resource-id="102105216" data-linked-resource-type="page" data-linked-resource-default-alias="Griffon Quick Start" data-base-url="http://docs.codehaus.org">Start developing with Griffon</a>!</li>
</ol>