What is CustomBuild?

CustomBuild is a tool which manages DirectAdmin-related services, such as WWW, E-mail, SQL, PHP, and others. Most of the packages are compiled from the source. The build process takes some time, but it provides some additional benefits such as the following:

  • it's easy to customize the components,
  • new versions/releases appear very fast,
  • newest libraries are used with the components,
  • and it's simple to update to latest versions even if they're not available in DirectAdmin file servers.

Most of the time, services will have a lower memory footprint as a result of building them with the desired options only.

CustomBuild is extremely powerful and highly customizable.

What version of CustomBuild am I running?

At the moment, CustomBuild 2.0 is the latest release of CustomBuild. It has its revision number changed on update time.

To view your CustomBuild version, run the following:

cd /usr/local/directadmin/custombuild
./build version

For example:

# ./build version
2.0.0 (rev: 2251)

Functionality between versions of CustomBuild varies, and that's why we strongly recommend updating CustomBuild to the latest version before doing any actions. To update CustomBuild, run:

./build update

If your system is a very old one, there is a chance you might be running and end-of-life version of CustomBuild. You may follow the upgrade instructions hereopen in new window to get it upgraded.

Getting started

CustomBuild has a graphical user interface in DirectAdmin, though you may use the command-line tool if you prefer. The /usr/local/directadmin/custombuild directory contains the build script that is used to execute the commands, and the file options.conf stores the settings in effect. Some of the most useful commands are discussed below.

Firstly, we need to enter CustomBuild directory, so that we would not need to enter full path when calling the 'build' script:

cd /usr/local/directadmin/custombuild/

Get a libashst of CustomBuild installed software on the server:

./build versions

Get some general help on ./build commands:

./build help

View the possible configuration options:

./build opt_help

View the possible configuration options with extended details:

./build opt_help full

Recompile Apache and PHP:

./build apache
./build php

Rewrite WWW server configuration files:

./build rewrite_confs

CustomBuild settings

You may use grep for variable in options.conf file:

# cd /usr/local/directadmin/custombuild/
# grep webserver options.conf

Or just use the ./build options command. The output will be formatted:

./build options

My Connection to files.directadmin.com is slow

If your installs of DA are downloading files slowly from the files.directadmin.com server, you can use one of our mirrors instead.

The current, official list of mirrored file servers is as follows:


3rd party:


There are many 3rd party mirrors not mentioned here. Note that DirectAdmin does not manage them, use them at your own risk. To enable the search of 3rd party mirrors, run:

cd /usr/local/directadmin/custombuild
./build set unofficial_mirrors yes

The CustomBuild scripts have the ability to find you a faster mirror if you choose. They way to do this is to run:

cd /usr/local/directadmin/custombuild
./build update
./build set_fastest

and it will go through the servers.txt to find you a quicker files server.

When using the setup.sh in the normal interface mode (user input), it will ask to find the fastest mirror.

Selecting 'y' will do this for you, so no need to run this post-install (unless you selected 'n', have an older system, or one of the servers is dead).

You can manually set the value you'd like in your options.conf to override it, e.g.,


Current SSL cipher lists for DirectAdmin servers

By default, DirectAdmin uses the intermediate ssl_configuration (set in CustomBuild's options.conf file) to set the cipher lists for the services. ssl_configuration=old/intermediate/modern are set based on the lists provided by Mozilla's Handy cipher generatoropen in new window.

Last Updated: