Download the ISPConfig Manual for ISPConfig 3.1 (Date: 09/27/2016)

The good news first: the updated ISPConfig 3 Manual (version 1.4 for ISPConfig 3.0.5) is finally available (in PDF format).

On 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. It also lines out how to make your server more secure and comes with a troubleshooting section at the end.

ISPConfig Manual for ISPConfig 3.1 (Date: 09/27/2016)
Authors: Till Brehm, Falko Timme (c) ISPConfig UG

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 Download A Single Copy
(A HowtoForge subscription costs 5 EUR for one month or 25 EUR for six months.) (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!)


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 Download A Single Copy
(A HowtoForge subscription costs 5 EUR for one month or 25 EUR for six months.) (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!)


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 ISPConfig UG. 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, 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?

Share this page:

Suggested articles

15 Comment(s)

Add comment


By: Azizul


i want to create a server on centos 5.4 like mail server, proxy server, DHCP server etc.

By: peterpetr

I am looking for the new ISPconfig manual for the just released 3.1. Thank you.

By: till

You can download the new manual already on this page, the download links go to the 3.1 manual already. The page will get an update tomorrow to show the new manual details.

By: Ed


Seems to work well. A few questions:

1) Do you still recommend adding that security script (that offers a type of intruder detection notification, and puts a first level at the httpd level of defense agains ddos attacks)? If so, why isn't it included in the install automatically?

2) You don't mention anything about LetsEncrypt - so I guess it works automatically? Why don't you mention a few words about this. I own the manual, but it's over 2 years old and will buy another copy, when I feel sure up-to-date info about lets encrypt is included.


3) There are numerous options for enabling TLS in the config files we modify that are not enabled, and you don't mention them. Any reason why?





By: till

1) What we recommend is described in the official installation instructions (perfect server guides) and in the ISPConfig manual.

2) Let's Encrypt is described in detail in the manual, e.g. the installation ins chapter 3.1.1 and in the chapters about client and reseller limits and it's usage in the chapter about website options.

3) TLS is enabled for SMTP, POP3, IMAP, FTP and ISPConfig automatically by the ISPConfig installer, so there are no further settings required. If you prefer to alter the defaults, then you may do that of course.

By: edealsbiz

Hallo Till,

I bought the manual a couple of days ago and had a couple of issues:

- couldn't pay with PayPal as the PayPal script that you use keeps popping up an error message that my PayPal email address isn't valid (I tried on other browsers Edge, Chrome...same result :( ).

- I paid with my credit card and downloaded the manual.

I just realized today that it was the old manual:

Version 1.0 for ISPConfig 3.0.3

Author: Falko Timme <[email protected]> Last edited 09/30/2010

By: till

That's really strange, the old manual is not available as download on our servers anymore, to be sure I just tested the above link and it returns the current ISPConfig 3.1 manual, same with the links on Please contact me by email to the address you received the invoice from so I can check the purchase and send you the current manual. And the PayPal address verification and login page is directly from Paypal, it's not from HowtoForge, so we have no influence on acceptance or rejection of an address.

By: till

I guess I was able to find your purchase now and the email with the download link, I used your link and I got the ISPConfig 3.1 manual trough it. maybe you owned the old manual as well and mixed up an old copy with the newly downloaded? Please just download the manual again through the link you received from us, the link returns the current ISPConfig 3.1 manual.

By: Eric Koch

Thanks for your prompt response, I downloaded the manual again (I thought the link had expired) and have the latest version now, so you might be right the glitch came on my side when saving the document...

By: Vincent

Hello Mr. Till,

thank you for the great tutorial and software. Unfortunately i am not able to buy a single manual - supporting the project - since my shopping cart turns up empty. :(

Let me know !

By: till

Thank you for the notice. The link has been fixed now.

By: Andraz Kopac

Again I have an empty shopping cart with the link above?

By: Max

Me too, empty cart :(

By: Alan

I have the same problem!

By: till

The link works fine here, just tested in Chrome and Firefox. So I've no idea why the shopping cart is empty in your case. As alternative, you can buy a single copy of the manual from ISPConfig website as well: