Overview -> Setup
A Handy Address Book Server installs just like any Windows application.
Download the setup program from the download page,
and run it on your server to complete the installation.
A Handy Address Book Server by selecting "Start / All Programs / Handy
Address Book Server / Handy Address Book Server". If there are no port
conflicts you will see the GUI appear as shown in this
If you are running any web server (like IIS or Apache) on this same server,
you will want to change the port that Handy uses, so it will not conflict with
this other server. To do this, select "Administration... / Settings..."
from the GUI. Here you can select the port, as shown in this
screen shot. A good alternative
port number is 8080. After changing the port, select the "Start Server"
A Handy Address Book Server comes with no pre-defined users, and
permissions are set wide open, so this will probably be one of the first things
you will want to set up. See the "Installation Administration" page to
define new users, and set their initial permission level for new address books.
By default Handy Server stores the address book data on the server at:
or for versions of Windows prior to Vista, see:
C:\Documents and Settings\All Users\Application Data\AHABS
You can change the data folder by either using a command line argument, or
setting a registry value. To change the data folder using a command line
argument use the "/data" command line argument, as shown in this example:
ahabs.exe /data "C:\Data\HServer"
This example will start the Handy Server, and make the data folder
C:\Data\HServer. To change the data folder by setting a registry value,
set the value of "data folder" in this key:
Either method will change the location of where Handy Server stores data
files. The command line argument will take precedence if both methods are
used. If you are running Handy Server as a service you must use the
registry method if you wish to change the location of where data files are
stored. If you are running a 64 bit version of Windows, the registry
location for this preference will be at:
Banned IP Addresses:
Handy Server supports banning specified IP addresses. Banned IP addresses
will not be allowed to connect to the Handy Server. Banned IP addresses
are global, and apply to all installations within Handy Server. To ban
certain IP addresses, create and edit a file called "Deny.txt" in the data
folder. Type one IP address per line into this file you wish to ban.
The * wildcard is supported. Comments are also supported on lines
beginning with the # character. An example Deny.txt file is shown here:
# Here is a sample Deny.txt file
# Let's ban a specific IP address
# We can also ban a range of addresses by using the * wildcard