= Ubuntu =
[[TOC(heading=Platforms, depth=1, WindowsMinGW, VisualStudio, LinuxGentoo, LinuxDebian, LinuxUbuntu, LinuxTardis, MacOSX)]]

== Developers only ==
Please note that the following instructions are for developers who want to download and build the most recent changes of the source code and consider changing it in the future. If you only want to try out and play a stable version of Orxonox you should go to [wiki:download#Linux this page] and follow the instructions on how to install the Orxonox deb-package on Ubuntu.

== Tested on ==

We try to test Orxonox as often as possible and try to ensure to always have a running version in our trunk. Below there is a table of the most recent tests with different hardware and versions of Orxonox, Ubuntu and graphics drivers.

|| Hardware || Ubuntu ver. || Orxonox ver. / Revision || Tester || Date || Result || Graphics Driver ver. ||
|| Lenovo W500 || Lucid Lynx (10.04) || r6812 || [wiki:DamianFrick Damian Frick] || 30.04.2010 || success || - ||
|| Lenovo W500 || Maverick Meercat (10.10) || r7541 || [wiki:DamianFrick Damian Frick] || 24.10.2010 || success || - ||
|| IBM X60t  || Maverick Meerkat (10.10) || r7639 || [wiki:OliScheuss Oliver Scheuss] || 11.11.2010 || success || - ||
|| Sony Vaio CW || Lucid Lynx (10.04) || r7750 || [wiki:BenjaminKnecht Benjamin Knecht] || 08.12.2010 || success || Nvidia 256.35 ||
|| MacBookPro 5,3 || Lucid Lynx (10.04) || r8115 || kmaurus || 25.03.2011 || success || - ||
|| Sony Vaio CW || Natty Narwhale (11.04) || r8408 || [wiki:BenjaminKnecht Benjamin Knecht] || 05.05.2011 || success || Nvidia 270.41.06 ||
|| Lenovo W500 || Natty Narwhale (11.04) || r8412 || [wiki:DamianFrick Damian Frick] || 07.05.2011 || success || - || 
|| - || Oneiric Ocelot (11.10) || r8891 || [wiki:Jo Johannes Ritz] || 18.10.2011 || success || - ||
|| - || Precise Pangolin (12.04) || r9350 || [wiki:Jo Johannes Ritz] || 04.10.2012 || success || - || 
|| - || Saucy Salamander (13.10) || r9764 || [wiki:BenjaminKnecht Benjamin Knecht] || 11.11.2013 || success || Nvidia 304.88 ||
|| Lenovo T430 || Saucy Salamander (13.10) || r9934 || [wiki:Jo Johannes Ritz] || 22.12.2013 || success || - ||

== Dependencies ==

To install all tools and libraries Orxonox needs, use the following command
{{{
$ sudo apt-get install build-essential cmake libogre-dev libenet-dev \
libvorbis-dev libalut-dev libcegui-mk2-dev tcl-dev libboost-date-time-dev \
libboost-filesystem-dev libboost-thread-dev liblua5.1-0-dev subversion libtolua-dev libtolua++5.1-dev
}}}

In '''Ubuntu 13.10''' make sure to use `libogre-1.8-dev` instead of `libogre-dev` otherwise you need old versions of the Boost library. When using OGRE 1.8 be sure to apply the bug fix below.

== Ubuntu 12.04 - Workaround ==
 * Remove the packages "libcegui-mk2-0.7.5" and "libcegui-mk2-dev (0.7.5-8)". E.g. via Synaptic.
 * Download the old versions of both packages: libcegui-mk2-1 [[http://old-releases.ubuntu.com/ubuntu/pool/universe/c/cegui-mk2/libcegui-mk2-1_0.6.2-5.1_i386.deb i386]|[http://old-releases.ubuntu.com/ubuntu/pool/universe/c/cegui-mk2/libcegui-mk2-1_0.6.2-5.1_amd64.deb amd64]] and libcegui-mk2-dev [[http://old-releases.ubuntu.com/ubuntu/pool/universe/c/cegui-mk2/libcegui-mk2-dev_0.6.2-5.1_i386.deb i386]|[http://old-releases.ubuntu.com/ubuntu/pool/universe/c/cegui-mk2/libcegui-mk2-dev_0.6.2-5.1_amd64.deb amd64]] (If this doesn't work write to [wiki:BenjaminKnecht Beni] about it).
 * Protect the old packages from being updated automatically. Open Synaptic. Search for the packages. Select a package and click on "Package" and the item "Lock Version". Do the same with the other package.

== Ubuntu 13.10 (Saucy Salamander) - Plugin Directory Bug Fix ==
There is currently [https://bugs.launchpad.net/ubuntu/+source/ogre-1.8/+bug/1244592 a bug with the libogre-1.8 package in Ubuntu 13.10] where the plugin directory is wrongly named and our CMake script can't find the plugin libraries. To fix this you can do the following:

{{{
$ sudo ln -sf OGRE-1.8.0 OGRE-1.8.1
}}}

This creates a link from the correct directory name to wrong one and CMake will follow the link when searching for the plugin libraries. In case the bug will be fixed later on you might need to delete the link.

== Building ==
Now follow the steps described on the [wiki:LinuxSource building] page.

If you experience problems running Orxonox after building it on your own, see [wiki:LinuxProblems this page] or [wiki:about#Contact contact us].

== Development with your favorite IDE ==
CMake can create project files for [wiki:KDevelop3 KDevelop], [wiki:EclipseIDE Eclipse] or [wiki:CMake#UsingCMakegeneratedprojectfiles Code::Blocks] for coding. Click the links for further information.