Local development environment¶
Drupal tools setup¶
We are using Dev Tools for Drupal module and site development.
- Make sure that you have latest versions of all required software installed:
- Make sure that all local web development services are shut down (
curl https://raw.githubusercontent.com/dpc-sdp/dev-tools/master/install | bash
Find more information about Dev Tools at https://github.com/dpc-sdp/dev-tools.
Pygmy issues (macOS)¶
zsh: command not found: pygmy
1. Ensure that
ruby is installed on your machine by issuing the following command on your terminal. (Skip to step 3 if already installed).
If not installed, enter the following command to install to
brew install ruby
Update the PATH environment variable to point to Homebrew's Ruby installation. Replace
.bash_profileif you're using bash.
echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc
pygmyby issuing the following command:
gem install pygmy
- Update the PATH environment variable to add binaries installed by gem. Replace
3.0.0with the version number of
echo 'export PATH="/usr/local/opt/ruby/bin:/usr/local/lib/ruby/gems/3.0.0/bin:$PATH"' >> ~/.zshrc
Docker issues (macOS)¶
docker: Error response from daemon: dial uni docker.raw.sock: connect: no such file or directory
Solution: 1. Enter the following command to restart Docker service:
service docker restart
- If the error persists, reinstall Docker.
Ahoy issues (macOS)¶
Could not load API JWT Token, error was: [warning] 'email@example.com: Permission denied (publickey)'.
1. Ensure that your SSH public keys (either
ssh-ed25519) have been added to your Lagoon account settings. Replace
username with your own username.
On macOS, SSH keys can be found on the following directory:
On Windows, SSH keys are typically located at:
To generate SSH keys in macOS, follow these steps:
- Enter the following command in the terminal window:
ssh-keygen -t rsa
This starts the key generation process. When you execute this command, the ssh-keygen utility prompts you to indicate where to store the key.
Press the ENTER key to accept the default location. The ssh-keygen utility prompts you for a passphrase.
Type in a passphrase. You can also hit the ENTER key to accept the default (no passphrase). However, this is not recommended.
Your public key is saved to the
id_rsa.pub; file and is the key you should add to your Lagoon account settings. You can save this key to the clipboard by running the following command:
pbcopy < ~/.ssh/id_rsa.pub
See Pygmy Troubleshooting SSH Key Issues for more information.