Skip to main content

Updating DirectAdmin & CustomBuild Software

Keeping your server secure means keeping your software up to date. In DirectAdmin, updates are split into two categories:

  • The Control Panel: DirectAdmin itself (the interface).
  • The Software Stack: Services like Apache, PHP, MySQL, and Exim. These are managed via a tool called CustomBuild.
Backup First:
Updating services (especially PHP or MySQL) can sometimes cause compatibility issues with older websites.
We strongly recommend creating a Snapshot of your VPS before running the update commands.

1. Updating the Software Stack (CustomBuild)

This is the most common maintenance task. You do this via SSH using the CustomBuild script.

Step 1: Navigate to the CustomBuild directory

cd /usr/local/directadmin/custombuild

Step 2: Fetch the latest versions list

./build update

Step 3: Check available updates (Recommended)

Before installing, it is wise to see exactly what will change.

./build versions

This will show a list like: PHP 8.1.x to 8.1.y: update is available.

Step 4: Compile and Install Updates

If you are happy with the list, run the update command:

./build update_versions

Note: This process can take some time as it may need to compile software from source.

2. Updating DirectAdmin (The Interface)

DirectAdmin is usually configured to update itself automatically via a daily cron job. However, if you need to force an update manually:

Option A: Via the GUI

  1. Log in to DirectAdmin as admin.
  2. Go to Licensing / Updates.
  3. If a new version is available, click the Update DirectAdmin button.

Option B: Via SSH

/usr/local/directadmin/custombuild/build update_da