NES for Drupal 7 Installation Guide
Learn how to install NES for Drupal 7 using Direct Download, Composer, or Drush installation methods.
Installation Methods
HeroDevs offers three methods for downloading and installing NES for Drupal 7: Composer Installation, Direct Download and Manual Installation, and Drush Installation.
It is highly recommended that you use version control for your project to allow you to revert changes to your project.
If you need a different installation method, please contact support@herodevs.com.
ALWAYS back up your site before installing NES for Drupal 7.
ALWAYS test NES for Drupal 7 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:
Command Line
In a terminal, set the NES_ACCESS_TOKEN environment variable:
NES_ACCESS_TOKEN=<your-access-token-beginning-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.13+7.103.1:drupal" && curl --header "Authorization: Bearer $NES_ACCESS_TOKEN" --output ./release.zip \
--location "https://registry.nes.herodevs.com/composer/pkg/neverendingsupport/drupal/$NES_D7_VERSION/release.zip"
Replace 7.103.13+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. The Drupal root is the folder that includes the files install.php and index.php.
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. Example if your Drupal root is in the project root:
unzip -o release.zip .
Example if your Drupal root is in a subfolder like web or docroot and the zip archive has been downloaded to the project root:
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 in the Drupal root like .htaccess, .gitignore, etc., you can exclude them from being overwritten by using the -x or --exclude flags on Linux/macOS and Windows respectively.
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 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-beginning-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.13+7.103.1:drupal/release.zip
Replace 7.103.13+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!
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. The Drupal root is the folder that includes the files install.php and index.php.
unzip -o release.zip .
Example if your Drupal root is in a subfolder like web or docroot and the zip archive has been downloaded to the project root:
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 in the Drupal root like .htaccess, .gitignore, etc., you can exclude them from being overwritten by using the -x or --exclude flags on Linux/macOS and Windows respectively.
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 for more information on excluding files.
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.13+7.103.1:drupal" --no-update
Replace 7.103.13+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-beginning-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.13+7.103.1:drupal" && curl --header "Authorization: Bearer $NES_ACCESS_TOKEN" --output ./release.zip \
--location "https://registry.nes.herodevs.com/composer/pkg/neverendingsupport/drupal/$NES_D7_VERSION/release.zip"
Replace 7.103.13+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 NES for Drupal 7. As of Drupal NES 7.103.5+7.103.1:drupal, NES for Drupal 7 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.