[[PageOutline]]

= Getting started =

== Users ==

=== Downloading hackable:1 ===

You can obtain the stable releases of hackable:1 here:

http://download.hackable1.org/

Currently only the Openmoko Freerunner is supported.

=== Installing hackable:1 ===

Installation instructions are found here:

http://download.hackable1.org/INSTALL.txt

=== Troubleshooting ===

 1. You can browse the [https://trac.hackable1.org/trac/report/1 existing, known problems]
 1. If you are still stuck, you can then open a ticket yourself
 1. There is a [http://lists.hackable1.org/mailman/listinfo/hackable1-user mailing-list for users], with [http://lists.hackable1.org/pipermail/hackable1-user/ archives]
 1. You can also get support from the IRC channel `#hackable1` on the [http://freenode.net/irc_servers.shtml Freenode network]

== Developers ==

=== Get the code ===

You can obtain the source code anonymously:
{{{
$ svn co svn://trac.hackable1.org/hackable1
}}}

Otherwise, if you are an official developer, you should access the code this way:
{{{
$ svn co svn+ssh://trac.hackable1.org/var/lib/svn/hackable1
}}}

`svn` also accepts the `--username <your username>` option if necessary.

=== Setuo the cross-compilation toolchain ===

See CrossCompiler for instructions on how to download or build a cross-compilation environnement and how to create new packages.

=== Source code structure ===

Our SVN tree is currently organized like this:

|| '''Directory''' || '''Description''' ||
|| `vendors` || Source code maintained by third-parties outside of hackable:1 ||
|| `trunk/src` || Applications specifically maintained by hackable:1's team ||
|| `trunk/packages` || Meta-data for software packaging in hackable:1 ||
|| `trunk/build` || Images generation scripts and configuration ||

=== Unstable images ===

The development images are found here:
http://build.hackable1.org/