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 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 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 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
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):
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.
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
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.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"
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.