Known issues

Global

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

fixed in version 1.1.0-beta5

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 "your_email@example.com"

I get a perl error when executing update_local.sh 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 update_local.sh

#!/bin/bash
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")
else
  SCRIPT_ABSOLUTE_PATH=$(readlink -f "$0")
fi

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

Symptoms

In the browser:

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

or

<h1>Additional uncaught exception thrown while handling exception.</h1><h2>Original</h2><p>PDOException: SQLSTATE[HY000] [2002] No such file or directory in drupal_is_denied() (line 2193 of /var/www/html/docroot/includes/bootstrap.inc).</p><h2>Additional</h2><p>PDOException: SQLSTATE[HY000] [2002] No such file or directory in _registry_check_code() (line 3490 of /var/www/html/docroot/includes/bootstrap.inc).</p><hr />Drush command terminated abnormally due to an unrecoverable error.

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.

Workaround

Find the line in etc/drupal/settings_local.php that contains the include of the domain module.
Cut {​==Highlighting==} ( = ensure the line is not present anymore in the file) 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.

MacOS

Docker desktop won't start after an update

There are multiple reported issues about Docker for Mac not starting after updating, see this Github issue.

If you're in this state, following command may help you:

sudo xattr -rd com.apple.quarantine /Applications/Docker.app

Projects with mutagen as sync strategy are broken.

Mutagen and composer v2 don't play along well, and result in a broken sync.
See this Github issue.

Workaround

Disable Docker Compose V2 support.
See the MacOS requirements.

Starting controlcenter shows an error about bad CPU type

If you start the control center and you see an error like this:

... docker-compose-v1: bad CPU type in executable

That means rosetta is not yet installed, or a Mac OS update broke it. In either case, rerun the command to install Rosettta to fix this. See the requirements section on how to install Rosetta.

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.

Fix:
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.

Explanation:
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 127.0.0.1" > /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 com.apple.finder 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)

  

Linux

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 trusted store on Linux based systems.

• In Chrome: open chrome://settings > Privacy and security > More > Manage certificates > Authorities > Import
• In Firefox: open about:preferences#privacy > View certificates > Authorities > Import

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