Drupal 7 NES Installation Guide - HeroDevs Never‑Ending Support

Learn how to install Drupal 7 NES using Direct Download, Composer, or Drush installation methods.

Installation Methods

HeroDevs offers three methods for downloading and installing Drupal 7 NES: Composer Installation, Direct Download and Manual Installation, and Drush Installation. It is highly recommended that you use version control for your project prevent being unable to revert changes.

If you need a different installation method, please contact support@herodevs.com.

ALWAYS back up your site before installing Drupal 7 NES.

ALWAYS test Drupal 7 NES on a local or development environment before pushing to production.

Direct Download and Manual Installation

Download using the direct download link.

Download Package

Download the package from either the direct download link or via the command line.

Direct Download Link

For the direct download link, use your access token as the password:

Download

Command Line

In a terminal, set the NES_ACCESS_TOKEN environment variable:

NES_ACCESS_TOKEN=<your-access-token-begining-with-"pat-">

For example:

NES_ACCESS_TOKEN=pat-12345-12345-12345-12345

Use cURL or wget to fetch the tarball:

NES_D7_VERSION="7.103.11+7.103.1:drupal" && curl --header "Authorization: Bearer $NES_ACCESS_TOKEN" --output ./nes-d7.zip \
--location "https://registry.nes.herodevs.com/composer/pkg/neverendingsupport/drupal/$NES_D7_VERSION/release.zip"

Replace 7.103.11+7.103.1:drupal with the most recent version number

When downloading, rename the file, if necessary, to release.zip and move it to your project's Drupal root. Depending on your setup, this may not be the project root.

Installation

This command overwrites existing files with changes. Be sure to back up your codebase before running the following command!

Unzip the archive over your existing site:

Linux/macOS

Windows

unzip -o release.zip

Example if your Drupal codebase is in the project root:

Linux/macOS

Windows

unzip -o release.zip .

Example if your Drupal codebase is in a subfolder like web or docroot and the zip archive has been downloaded to the project root:

Linux/macOS

Windows

mv release.zip /path/to/drupal/docroot/release.zip
cd /path/to/drupal/docroot/
unzip -o release.zip

When in doubt, use the full path to your Drupal installation.

The unzip -o and tar -xf commands overwrite your existing files and add new ones from the archive. They do not remove files that are not in the archive. However, always back up your codebase before making changes.

If you have customizations to files like your .htaccess, .gitignore, etc., you can exclude them from being overwritten by using the -x flag.

Linux/macOS

Windows

mv release.zip /path/to/drupal/docroot/release.zip
cd /path/to/drupal/docroot/
unzip -o release.zip -x .htaccess .gitignore

Check your unzip utility documentation or help for more information on excluding files.

Cleanup

Clear cache and check for any database changes:

drush cc all && drush updb

Verify your site works as expected.

At this point you can remove the downloaded .zip file from your folder.

Using cURL and Manual Installation

Download using command-line tools like cURL or wget by setting authentication headers.

Download package

In a terminal, set the NES_ACCESS_TOKEN environment variable:

NES_ACCESS_TOKEN=<your-access-token-begining-with-"pat-">

For example:

NES_ACCESS_TOKEN=pat-12345-12345-12345-12345

Use cURL or wget to download the tarball into your project root:

curl --header "Authorization: Bearer $NES_ACCESS_TOKEN" --output ./release.zip \
--location https://registry.nes.herodevs.com/composer/pkg/neverendingsupport/drupal/7.103.11+7.103.1:drupal/release.zip

Replace 7.103.11+7.103.1:drupal with the most recent version number

Unzip archive file

Be sure to back up your codebase before running the following command!

Unzip the archive over your existing site with (note the variation for macOS):

Linux/macOS

Windows

unzip -o release.zip /path/to/drupal

Example if your Drupal codebase is in the project root:

Linux/macOS

Windows

unzip -o release.zip .

Example if your Drupal codebase is in a subfolder like web or docroot and the zip archive has been downloaded to the project root:

Linux/macOS

Windows

unzip -o release.zip docroot/

When in doubt, use the full path to your Drupal installation.

Perform cleanup

Clear cache and check for any database changes:

drush cc all && drush updb

Verify that your site works as expected.

At this point you can remove the downloaded .zip file from your folder.

Composer Installation

Set up authentication

Create an auth.json file or update your existing one:

{
  "bearer": {
    "registry.nes.herodevs.com": "<your-access-token-beginning-with-'pat-'>"
  }
}

This file contains sensitive credentials and should be excluded from source control.

Configure repository

Add the HeroDevs repository to your composer.json file:

"repositories": [
  {
    "type": "composer",
    "url": "https://registry.nes.herodevs.com/composer/repository"
  }
]

Place this entry above packages.drupal.org to ensure proper precedence.

Install package

First, add Drupal NES:

composer require "neverendingsupport/drupal:7.103.6+7.103.1:drupal" --no-update

Replace 7.103.6+7.103.1:drupal with the most recent version number

Then install dependencies:

composer update drupal/drupal --with-dependencies --no-dev

Drush Installation

These instructions assume Drush is already installed on your system.

Download package

In a terminal, set the NES_ACCESS_TOKEN environment variable:

NES_ACCESS_TOKEN=<your-access-token-begining-with-"pat-">

For example:

NES_ACCESS_TOKEN=pat-12345-12345-12345-12345

Use cURL or wget to fetch the tarball:

NES_D7_VERSION="7.103.11+7.103.1:drupal" && curl --header "Authorization: Bearer $NES_ACCESS_TOKEN" --output ./nes-d7.zip \
--location "https://registry.nes.herodevs.com/composer/pkg/neverendingsupport/drupal/$NES_D7_VERSION/release.zip"

Replace 7.103.11+7.103.1:drupal with the most recent version number

Rename the file if necessary.

Create Make file

Create drupal7_nes.make with the following content (note the variation for macOS):

api = 2
core = 7.x
projects[drupal][version] = 7.103
projects[drupal][download][type] = "get"
projects[drupal][download][url] = "file:///var/www/html/release.zip"

On macOS, the last line will look something like this:

projects[drupal][download][url] = "file:///Users/<your-username>/Sites/<your-drupal-site>/release.zip"

Update the file path to match your project structure.

Execute the Make file

Execute the make command and complete Drupal's installation:

drush make drupal7_nes.make

Next Steps

Once installed, you can start using Drupal 7 NES. As of Drupal NES 7.103.5+7.103.1:drupal, Drupal 7 NES ships with the Drupal NES System module. For the best experience with HeroDevs, we recommend enabling the NES System module and running drush updb or navigating to the update.php page to perform a database update.