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.
If you need a different installation method, please contact sales@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 the direct download link using your access token as the password:
When downloading, rename the file to release.zip.
Installation
Be sure to back up your codebase before running the following command!
Unzip the archive over your existing site:
unzip -o release.zip /path/to/drupal
Example if your Drupal codebase is in the project root:
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:
unzip -o release.zip docroot/
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.
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 by setting authentication headers.
Download Package
Set your access token to an environment variable
NES_ACCESS_TOKEN=[YOUR ACCESS TOKEN BEGINNING WITH "pat-"]
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
Installation
Be sure to back up your codebase before running the following command!
Unzip the archive over your existing site:
unzip -o release.zip /path/to/drupal
Example if your Drupal codebase is in the project root:
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:
unzip -o release.zip docroot/
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.
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.
Composer Installation
Authentication Setup
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.
Repository Configuration
Add the HeroDevs repository to your composer.json file:
"repositories": [
{
"type": "composer",
"url": "https://registry.nes.herodevs.com/composer/repository"
}
]
Place this entry before packages.drupal.org to ensure proper precedence.
Package Installation
First, add NES Drupal:
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
These instructions assume Drush is already installed on your system.
Download Package
Use cURL 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:
core = 7.x
projects[drupal][version] = 7.103
projects[drupal][download][type] = "get"
projects[drupal][download][url] = "file:///var/www/html/nes-d7.zip"
Update the file path to match your project structure.
Run Installation
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 NES ships with the 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.