Debian
Guide compatible with ispCP 1.0.0 Stable
Preinstallation
Before you consider installing ispCP make sure you cared about the following issues:
- - If you are still using Debian Sarge please upgrade to Debian Etch or Debian Lenny.
- - Your Server has to be configured to use a resolvable fully qualified domain name. Here can you find hoster specific information how to do so.
The Installation
Make sure you are logged in with an user that has root privileges.
1. Extract the distribution files
# aptitude update
# aptitude upgrade
# aptitude install tar bzip2 wget lsb-release
# mkdir -p /usr/local/src/ispcp
# cd /usr/local/src/ispcp
# wget http://mesh.dl.sourceforge.net/sourceforge/ispcp/ispcp-omega-1.0.0.tar.bz2
# tar -xjvf ispcp-omega-1.0.0.tar.bz2
2. Change to the ispcp directory
# cd ./ispcp-*
If you are installing from a nightly build use the following command:
# cd ./web/svn/nightly
3. Install the required modules
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.
# stable deb http://ftp.de.debian.org/debian/ lenny main contrib non-free deb http://security.debian.org/ lenny/updates main contrib non-free
Now install the nescessary packages using aptitude:
# aptitude update # aptitude upgrade # aptitude install $(cat ./docs/Debian/debian-packages-`lsb_release -cs`)
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 yes when you are asked if you would like to continue installing without maildirs
Select no to force sync updates.
When you get to the proftpd screen, select standalone
4. Build the system
# make install
5. Copy all the directories into the system
We recommand you to make a backup of your current system state.
# cp -Rv /tmp/ispcp/* /
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.
# mysql_secure_installation
NOTE: DON'T USE @ or $ or % in your Password!!!
7. Setup the system
Change into the engine/setup directory:
# cd /var/www/ispcp/engine/setup
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.
# perl ./ispcp-setup
7. Clean the temp directory
# rm -fR /tmp/ispcp
Download languagepackage if u need other than english http://www.isp-control.net/ispcp/wiki/translations and install it with ispCP-Admin-Panel.
8. 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.
