[[TracNav(TracNav/TOC_install)]]
= Debian GNU/Linux =

''Edited: 15. Sep. 2008 by [wiki:FelixSchulthess Felix]''[[br]]
''Checked (dependencies reviewed) (r1571): 9. Jun. 2008 by [wiki:BenjaminKnecht Beni] on Ubuntu 8.04 (Hardy Heron)

Unfortunately there is no Debian package available for Orxonox yet. We're eager to release one, though. Until then, you can get a copy of Orxonox' source code and build it on your own.

== Dependencies ==

To install all tools and libraries Orxonox needs, use the following command
{{{
  $ sudo aptitude install build-essential cmake libogre-dev libois-dev libboost-thread-dev libopenal-dev libalut-dev libenet-dev libfreeimage-dev libzzip-dev liblua5.1-0-dev tcl8.4-dev
}}}

== Get the Source Code ==
Now get a copy of the code by checking out the trunk via anonymous subversion login. This will download the latest stable version to the directory ''trunk''. If you have trouble using SVN, go [wiki:SVN here].
{{{
$ svn co http://svn.orxonox.net/orxonox/trunk trunk
}}}
You won't be able to contribute your own code (check in) with the anonymous subversion repository. You have to ask us for a username/password combination. If you already have an account, check the code out like this:
{{{
$ svn co https://svn.orxonox.net/orxonox/trunk trunk
}}}
You will then be asked for the username and password, that you got from us.
Furthermore, you will need to check out the media repository. This repository contains all the graphics, fonts and sounds for Orxonox. To check it out, do:
{{{
$ svn co https://svn.orxonox.net/data/Media media
}}}
Now make sure, you have set the correct path to your media directory in the file orxonox.ini.

== Compiling ==
Just cd to the trunk directory, then execute configure and make:
{{{
$ cd orxonox-trunk
$ cmake .
...
$ make
...
$ ./run
}}}

== Possible Bugs ==
=== Strange Sound ===
Install normally and run it with the Alsa-OSS-wrapper
{{{
$ sudo aptitude install alsa-oss
...
$ aoss ./run
}}}

=== Running ===

If ./run doesn't work check out ''bin/orxonox.ini'' and compare the given data-path with the one you downloaded the data repository to. If the paths don't match, change it in the orxonox.ini and try ./run again.

=== Graphics ===
Using the "radeon" driver with your ATI graphics card (on Gutsy) will result in ugly shadow bugs in Ogre. Use flgrx instead.

=== Ogre ===
If you haven't installed Ogre with the package manager, you'll have to change the path in ''trunk/bin/plugin.cfg'' from ''/usr/lib/OGRE'' to ''/usr/local/lib/OGRE''.