====== Debian ======
===== Version Info =====
^ispCP Version |1.0.7 RC1                                 |
^INSTALL Script|2.6                                       |
^Maintainer    |ispCP DevTeam                             |
^Linux Distros |Debian Lenny, Squeeze                     |
^Last Update   |04.10.2010                                |

===== Preinstallation =====

Before you consider installing ispCP make sure you cared about the following issues:\\

**<fc #FF0000>DEBIAN SARGE IS NOT SUPPORTED. DEBIAN ETCH SUPPORT IS NO LONGER SUPPORTED SINCE 1.0.7</fc>**

<fc #FF0000>Your Server has to be configured to use a resolvable fully qualified domain name. [[howto:hostname|Here]] can you find hoster specific information how to do so.</fc>

===== The Installation =====
Make sure you are logged in with an user that has root privileges.
\\
===== STEP 1 - Download & Extract the distribution files =====
If not installed on your System, please install "aptitude" via:
<code># apt-get install aptitude</code>
\\
<code># aptitude update && aptitude safe-upgrade</code>
<code># aptitude install tar bzip2 wget lsb-release</code>
<code># mkdir -p /usr/local/src/ispcp</code>
<code># cd /usr/local/src/ispcp</code>
\\
Download your Copy of ispCP from [[http://sourceforge.net/projects/ispcp/files/|SourceForge.net]] with wget
\\
\\
Untar the File:  (REPLACE .X.X with your downloaded Version)
\\
\\
<code># tar -xvf ispcp-omega-1.X.X.tar.bz2</code>
\\
===== STEP 2 - Change to the ispcp directory =====
(REPLACE .X.X with your downloaded Version)
\\
\\
<code>
# cd ispcp-omega-1.X.X
</code>
\\
===== STEP 3 - Install the required packages =====
**Make sure that the __non-free__ repository is present in  your __/etc/apt/sources.list__ like in the following example. When the non-free repository is not available on your system, all-important packages will be missing.**
\\
<file>
 # stable
 deb http://ftp.de.debian.org/debian/            lenny          main contrib non-free
 deb http://security.debian.org/                 lenny/updates  main contrib non-free
</file>

Now install the nescessary packages using aptitude:
\\
<code>
# aptitude update
# aptitude safe-upgrade
# aptitude install $(cat ./docs/Debian/debian-packages-`lsb_release -cs`)
</code>
\\
When you get to the "courier screen" select **no** to web directories.
\\
\\
When you get to the "postfix screen" select **internet site** 
\\
If your debian setup is correct your domain should already be displayed on the screen.
If not, enter the domain without the 'www.' portion (i.e. yourdomain.com)
\\
\\
Select **no** when you are asked if you would like to create directories for web-based administration
\\
\\
When you get to the proftpd screen, select **standalone**\\
\\
===== STEP 4 - Build the system =====
<code>
# make install
</code>\\
===== STEP 5 - Copy all the directories into the system ===== 
We recommand you to make a backup of your current system state.

<code>
# cp -R /tmp/ispcp/* /
</code>\\
===== STEP 6 - Configure MySQL server=====
Change or create MySQL root password, remove anonymous users, disallow root login remotely, remove test database (and access to it), reload privilege tables.
<code>
# mysql_secure_installation
</code>
\\
**NOTE: DON'T USE @ or $ or % in your Password!!!**
\\
===== STEP 7 - Setup the system =====
Change into the engine/setup directory:

<code>
# cd /var/www/ispcp/engine/setup
</code>\\
All questions should be self-explanatory. Anyway if you don't know what to answer to a specific question don't hesitate to ask the community at the ispCP Forum.\\
<code>
# perl ./ispcp-setup
</code>\\
===== STEP 8 - Clean the temp directory =====
<code>
# rm -fR /tmp/ispcp
</code>\\

Download languagepackage if u need other than english [[http://www.isp-control.net/ispcp/wiki/translations]] and install it with ispCP-Admin-Panel.
\\
===== STEP 9 - That's it! =====

**NOTE:After Installation, please check your proftpd.conf and disable IP6 Support!!!**

You can now access ispCP with your preferred browser by typing the admin address you specified during the installation process.
\\
\\
**http://admin.your-domain.tld** 
\\
\\
When you are not able to access the control panel something really went wrong. Doublecheck that you have not missed any step of this installation guide you may consider asking in the ispCP Forum for help.