==== Installing Red5 on Debian ====

This howto was provided by Nathan P. Johansen.

The following are steps used to get Red5 running on a Debian machine. This is the development version of Red5.

Before beginning this make sure you are running these commands as root.

  - Install [[http://subversion.tigris.org|Subversion]]:  <code>apt-get install subversion</code>
  - Install tools to build your own Debian packages:<code>
  apt-get install dpkg-dev
  apt-get install debhelper
  apt-get install dh-make
  apt-get install devscripts
  apt-get install fakeroot</code>
  - Install Java (see this [[http://chrismetcalf.net/blog/archives/2005/05/19/mini-howto-installing-java-on-debian-unstable|tutorial]] for more info): <code>apt-get install java-package</code>
  - Install Apache [[http://ant.apache.org|Ant]] 1.7: <code>
  wget http://apache.mirror.transip.nl/ant/binaries/apache-ant-1.7.0-bin.tar.gz
  gzip -d xf apache-ant-1.7.0-bin.tar.gz
  tar -xf apache-ant-1.7.0-bin.tar
  cd apache-ant-1.7.0
  mv apache-ant-1.7.0 /usr/local/ant
  export ANT_HOME=/usr/local/ant</code>
  - Once Java and Ant are all set up you simply download the latest development version of Red5 to your box.<code>
  svn co http://red5.googlecode.com/svn/java/server/trunk red5-trunk</code> That will create a folder in your current directory called red5-trunk.
  - Navigate to the red5-trunk directory and run <code>/usr/local/ant/bin/ant</code> That will build the project on your machine.
  - At this point you will need to create a red5 directory in the /usr/local/red5 directory.<code>mkdir /usr/local/red5</code>
  - Then you will want to copy the contents of the dist(distribution) folder to /usr/local/red5 like so <code>cp -R red5-trunk/dist/* /usr/local/red5/</code>
  - We need need to fix the permissions on the red5.sh file: <code>cd /usr/local/red5
chmod 755 red5.sh</code>
  - To run the server you have a few options using the red5.sh file. Run the server by either running <code>sh red5.sh &</code> or <code>./red5.sh &</code> This will start the Red5 service manually.
  - Verify the correct ports are being bound to: <code>netstat -ant</code> You may need to edit the red5.properties file in the /usr/local/red5/conf directory if you can’t connect to your server from an external location. Try to connect to the server before you modify the properties file because you may be able to connect to it with no problems.