Installation Guide

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.

Direct Download and Manual Installation

Download using the direct download link.

Download Package

Download the package from the direct download link using your access token as the password:

Download

When downloading, rename the file to release.zip.

Installation

Unzip the archive over your existing site:

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.

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.8+7.103.1:drupal/release.zip
# Be sure to replace `7.103.8+7.103.1:drupal` with the most recent version

Unzip archive file

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-'>"
  }
}

Configure repository

Add the HeroDevs repository to your composer.json file:

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

Install package

First, add Drupal NES:

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

Then install dependencies:

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

Drush Installation

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.8+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.8+7.103.1:drupal` with the most recent version number

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/nes-d7.zip"

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

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

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.