User Manual

Download The ISPConfig Manual for ISPConfig 3.1

The good news first: the updated ISPConfig 3.1 Manual is finally available (in PDF format).

More then 400 pages, it covers the concept behind ISPConfig (admin, resellers, clients), explains how to install and update ISPConfig 3.1, includes a reference for all forms and form fields in ISPConfig together with examples of valid inputs, and provides tutorials for the most common tasks in ISPConfig 3.1. It also lines out how to make your server more secure and comes with a troubleshooting section at the end.

ISPConfig 3.1 Manual; Date: 09/27/2016
Authors: Till Brehm, Falko Timme
More then 400 pages

Now the bad news: we can’t offer it for free. But it will be available for as low as 5 EUR per copy – we think this price is more than fair for a manual with more than 400 pages.

Download Through Your HowtoForge Subscription

A HowtoForge subscription costs 5 EUR for one month or 25 EUR for six months.

Download A Single Copy

A single copy costs 5 EUR; you will receive an email with a download link that is active for ten days. Please note that this option does not include any updates!

Price: € 5.00 (excl. VAT)


We don’t want to bore you with long explanations, so here are the facts:

Why Do We Charge For The ISPConfig 3 Manual?

We hope that this will allow us to employ an additional full-time ISPConfig developer who can disburden the core team. This would accelerate ISPConfig development a lot and also allow us to provide more support for ISPConfig users.

Will ISPConfig 3 Continue To be Free?


What Does the ISPConfig 3 Manual Cost?

You can download it either through an active HowtoForge subscription, or you can buy a single copy.

Downloading through a HowtoForge subscription has the advantage that you get updates of the manual for free as long as you are a subscriber, while if you buy a single copy, no updates are included (i.e., you would have to pay again for new versions of the manual).

A HowtoForge subscription costs 5 EUR for one month or 25 EUR for six months.

If you want to download a single copy of the ISPConfig 3 manual, this costs you 5 EUR which is equal to buying a one-month HowtoForge subscription.

Download Through Your HowtoForge Subscription

A HowtoForge subscription costs 5 EUR for one month or 25 EUR for six months.

Download A Single Copy

A single copy costs 5 EUR; you will receive an email with a download link that is active for ten days. Please note that this option does not include any updates!

Price: € 5.00 (excl. VAT)

Currently, payments can be made only in Euros (EUR). Payments in other currencies will be automatically converted to EUR based on current exchange rates.

Your payment will be made to:

ISPConfig UG (haftungsbeschränkt)

Am Berge 2
21335 Lüneburg

Refund Policy

Because we are based in the E.U., there is a 7-day cooling off period for all distance sales, during which time customers have a legal right to an immediate and unconditional refund upon return of the goods, with money returned to the customers’ account within 30 days.

However, the law contains explicit exemptions for computer software and services (downloadable software is classed as a service), so this cooling-off period will only apply where you have not used our service, i.e. downloaded the ISPConfig 3 Manual. Equally, for physical goods (CD-ROMs), the cooling-off period will terminate when the seal is broken on the packaging.

Copyright Information

The ISPConfig 3 manual is protected by copyright. No part of the manual may be reproduced, adapted, translated, or made available to a third party in any form by any process (electronic or otherwise) without the written specific consent of projektfarm GmbH. You may keep backup copies of the manual in digital or printed form for your personal use. All rights reserved.

This means it is not allowed to redistribute the ISPConfig 3 manual in any form (for example by offering it as a download on your web site). Your copy of the ISPConfig 3 manual will be personalized with your real name (or HowtoForge username) and email address.

If you are an ISP and need multiple copies (e.g. for your clients), please contact us ([email protected]), and we will find a solution.

Table Of Contents

1 Conventions Used In This Manual
1.1 Commands
1.2 Contents Of Files
1.3 File Names, Protocol Names, System Specifications, Technical Specifications, User Names, Etc.
1.4 Highlighting

2 ISPConfig Users – Admin, Resellers, And Clients
2.1 Summary
2.1.1 admin
2.1.2 Resellers
2.1.3 Clients

3 Installation & Updating
3.1 Single Server Setup
3.1.1 HHVM and Let’s Encrypt
3.1.2 Metronome XMPP
3.1.3 ISPConfig 3.1 Installation
3.2 Multiserver Setup
3.2.1 Installing A Multiserver Setup With Dedicated Web, Email, DNS And MySQL Database Servers On Debian 8 With ISPConfig 3.1 Installing The Five Debian Base Systems Installing The Web Server Installing The Mail Server Installing The MySQL Database Server Installing The Primary DNS Server Installing The Secondary DNS Server Adjust The Server Settings In ISPConfig 3.1.3 Mirror Setup
3.3.1 Installing A Web, Email And MySQL Database Cluster On Debian 8 With ISPConfig 3.1 General note Install the Master Server Prepare the Slave Server Keyless Login from Server1 to Server2 MySQL Master-Master Replication Install ISPConfig on the Slave Server Install Unison Sync Emails with Dovecot Additional Notes
3.4 Updating
3.4.1 Creating A Backup
3.4.2 Command Line Update

4 Reference
4.1 Tabs
4.2 Login
4.3 Home
4.4 Tools
4.4.1 User Settings Password and Language
4.4.2 Interface Interface
4.4.3 Sync Tools Resync
4.4.4 Import ISPConfig 3.1 mail PowerDNS Tupa
4.5 Client
4.5.1 Clients Add Client Edit Client Edit Client-Templates
4.5.2 Resellers Add Reseller Edit Reseller
4.5.3 Messaging Edit Client Circle Send Email Email Templates
4.5.4 Domains Add or Edit Domains
4.6 Sites
4.6.1 Websites Website Subdomain for website Subdomain (Vhost) Aliasdomain for website Aliasdomain (Vhost)
4.6.2 Database Databases Database Users
4.6.3 Web Access FTP-Accounts WebDAV-Users Protected Folders Protected Folder Users
4.6.4 Command Line Shell-User Cron Jobs
4.6.5 APS Installer Available packages Installed packages Update Packagelist
4.6.6 Statistics Web traffic FTP Traffic Website quota (Harddisk) Database quota
4.7 Email
4.7.1 Email Accounts Domain Domain Alias Email Mailbox Email Alias Email Forward Email Catchall Email Routing
4.7.2 Mailing List Mailing List
4.7.3 Spamfilter Whitelist Blacklist User / Domain Policy
4.7.4 Fetchmail Fetchmail
4.7.5 Statistics Mailbox quota Mailbox traffic Backup Stats
4.7.6 Global Filters Postfix Whitelist Postfix Blacklist Content Filter Relay Recipients
4.7.7 Jabber/XMPP XMPP Domain
4.8 DNS
4.8.1 DNS Wizard Add DNS Zone Import Zone File Templates
4.8.2 DNS Zones
4.8.3 Secondary DNS Secondary Zones
4.9 System
4.9.1 User Management CP Users Remote Users
4.9.2 System Server Services Server Config Server IP addresses Additional PHP Versions Directive Snippets Firewall Server IPv4 Mapping
4.9.3 Interface Main Config
4.9.4 Apps & Addons Repositories Packages Updates
4.9.5 Language Editor Languages New Language Merge Export Import
4.9.6 Remote Actions Do OS-Update Do ISPConfig-Update
4.10 Monitor
4.10.1 System State (All Servers) Show Overview Show System-Log Show Jobqueue
4.10.2 Server to Monitor
4.10.3 Hardware Information Show CPU Info
4.10.4 Server State Show Overview Show Update State Show RAID State Show Server Load Show Disk Usage Show Memory Usage Show Services Show OpenVz VE BeanCounter Show MySQL database size Show Monit Show Munin
4.10.5 Logfiles Show Mail Queue Show Mail Log Show Mail Warn-Log Show Mail Error-Log Show System-Log Show ISPC Cron-Log Show Freshclam-Log Show Clamav-Log Show RKHunter-Log Show fail2ban-Log Show IPTables
4.11 Help
4.11.1 Support Send message View messages
4.11.2 FAQ Manage Sections Manage Questions
4.11.3 About ISPConfig Version
4.13 VServer
4.13.1 OpenVZ Virtual Servers OS Templates VM Templates IP addresses
4.14 Global Search

5 Howtos
5.1 How Do I Create A Reseller?
5.2 How Do I Create A Client?
5.3 How Do I Create A Web Site?
5.4 How Do I Create An SSL Web Site?
5.4.1 How Do I Import An Existing SSL Certificate Into A Web Site That Was Created Later In ISPConfig?
5.5 How Do I Redirect My Web Site To Another Web Site Or To A Specific Directory On The Server?
5.6 How Do I Create An FTP Account So That I Can Upload Files To My Web Site?
5.7 How Can I Use Perl/CGI Scripts With My Web Site?
5.8 How Do I Create An Email Account?
5.9 How Do I Activate The Spamfilter/Virus Scanner For An Email Account?
5.10 How Do I Blacklist/Whitelist Email Addresses In The Spamfilter?
5.11 How Do I Fetch Emails From A Remote Server With ISPConfig And Put The Emails In A Local Email Account?
5.12 How Do I Create A DNS Zone?
5.13 How Do I Create A Secondary DNS Zone?
5.14 How Do I Create A Mirror?
5.15 How Do I Split Up Services Between Multiple Servers?
5.16 How Do I Unblock An IP Address That Got Blocked By fail2ban?
5.17 How Do I Create A Subdomain And Redirect It To A Different Folder/Web Site?
5.18 How Do I Manually Configure New IP Addresses On My System?
5.19 How To Build A PureFTPd Debian Package For OpenVZ Virtual Machines (Without Capabilities Enabled)
5.20 How To Display Hidden Files With PureFTPd On Debian And Ubuntu Linux
5.21 PureFTPd Does Not Show More Than 2,000 Files On Debian And Ubuntu
5.22 How To Speed Up Logins In PureFTPd On Debian Or Ubuntu Linux By Disabling Name Resolving
5.23 How To Enable Verbose Logging In PureFTPd On Debian And Ubuntu Linux
5.24 How To Enable FTPS For PureFTPd On Debian And Ubuntu Linux
5.25 How Can I Access SquirrelMail From My Web Sites?
5.25.1 Apache
5.25.2 nginx
5.26 How Can I Access phpMyAdmin From My Web Sites?
5.26.1 Apache
5.26.2 nginx
5.27 How Can I Access Mailman From My Web Sites?
5.27.1 Apache
5.27.2 nginx

6 Security Considerations
6.1 How Do I Disable Certain PHP Functions?
6.2 Enabling SSL For The ISPConfig Web Interface
6.3 Using SuExec For The ISPConfig Web Interface
6.4 What Are Secure Settings For Web Sites Created Through ISPConfig?
6.5 How Do I Make fail2ban Monitor Additional Services?
6.5.1 PureFTPd
6.5.2 SASL
6.5.3 Courier
6.5.4 Dovecot

7 Troubleshooting
7.1 How Do I Find Out What Is Wrong If ISPConfig Does Not Work?