Known isssues


My SSH key isn't accepted, and I'm sure my passphrase is correct

The Golang ssl library only supports a subset of ssh key formats.
to be sure your passphrase is correct, run the command in debug mode:

LP_DEBUG=TRUE dlpc add_ssh_key /tmp/test_key

If the last last line(s) contains the following string, the your key won't work with Golang, and thus Launchpad.

ssh: cannot decode encrypted private keys

There is currently no way to convert a key to PEM format, so you can only re-generate one.

ssh-keygen -t rsa -b 4096 -m pem -C ""

I get a perl error when executing script in the shell

The current version of the skeleton has scripts that depend on perl
Perl isn't available in the shell container, due to being too big in size.

it is safe to replace following line in

SCRIPT_ABSOLUTE_PATH=$(perl -MCwd -le 'print Cwd::abs_path(shift)' "$0")

with this

# On OSX we can't use readlink, as it doesn't support the -f flag.
if [ $(uname | grep -iE "^darwin") ]; then
  SCRIPT_ABSOLUTE_PATH=$(perl -MCwd -le 'print Cwd::abs_path(shift)' "$0")
  SCRIPT_ABSOLUTE_PATH=$(readlink -f "$0")

My D7 project with the domain access module gives an error in the browser or when running drush commands


In the browser:

Call to undefined function module_list() in /var/www/html/docroot/includes/

In the shell:

Drush command terminated abnormally due to an unrecoverable error.

This is caused by the domain module being bootstrapped before the correct db connection info is configured by launchpad.
There is currently no fix in launchpad, but there is a workaround.


Find the line in etc/drupal/settings_local.php that contains the include of the domain module.
Cut the line, and paste it in docroot/sites/default/settings.php

You have to repeat those steps every time you start the project, as the settings file gets regenerated.


composer.lock or composer.json files or vendor folder vanish in the shell container

This is caused by (knowingly) editing those files or folder locally.
E.g. adding a dependency or removing the vendor folder will trigger this.
Switching a branch can also trigger this, as these files will be recreated if they changed.

Do not rely on those files in the container, and run composer commands locally. Be sure you are on the same version of composer as in the shell!

Workaround if you realy need to use those files or folder in the shell container
Do the necessary changes to the files or folder locally and restart the project.

Those files are mounted as a volume in the shell container.
This is kind of a workaround, as volumes should be directories.
Volumes are created based on the inode of the file or directory.
When editing the file, the inode may change, thus breaking the mount.

I can't browse to a launchpad project in Firefox or Safari?

This is a known missing feature from launchpad, but there is an easy workaround for now.

execute following commands:

sudo mkdir /etc/resolver
sudo bash -c 'echo "nameserver" > /etc/resolver/localhost'

I can't see the .dropsolid_launchpad folder in Finder or in an open dialog

The .dropsolid_launchpad folder is a hidden folder, and by default MacOS hides hidden files and folders.

  • To show them in Finder, execute this in a terminal window:

    defaults write AppleShowAllFiles YES.

  • To show hidden files and folders in a open dialog of any program, use the Command+Shift+. key combination inside the dialog.

  • To show hidden fils and folders in a create project dialog in PHPStorm, click on the eye icon (Show hidden files and directories)

    Hidden folders PHPStorm


The dnsmasq container won't start on Ubuntu.

Ubuntu has some (dirty) magic to run his own dns resolution deeply nestled in the NetworkManager.
There is currently no documented way to make Launchpad work nicely together.
For now add the hostnames of the projects you want to see to your /etc/hosts file.

CA certificate can't be added automatically

You have to add it manually to the local certificate directory.

This part of the documention isn't complete yet, but we're planning to improve / extend it.