Method Start

pkg/ddevapp/ddevapp.go:1489–2104

Start initiates docker-compose up

()

// Start initiates docker-compose up
func (app *DdevApp) Start() error {
	var err error
	if app.IsMutagenEnabled() && globalconfig.DdevGlobalConfig.UseHardenedImages {
		return fmt.Errorf("mutagen is not compatible with use-hardened-images")
	}

	if dockerutil.IsDockerRootless() && !globalconfig.DdevGlobalConfig.NoBindMounts {
		// See https://github.com/moby/moby/issues/45919
		// See https://github.com/moby/moby/issues/2259
		return fmt.Errorf("bind mounts can't be used with Docker Rootless.\nRun `ddev config global --no-bind-mounts` and try again")
	}

	if err := globalconfig.CheckForMultipleGlobalDdevDirs(); err != nil {
		util.WarningOnce("Warning: %v", err)
	}

	if !globalconfig.IsInternetActive() && globalconfig.DdevDebug {
		util.WarningOnce("Internet connection not detected, DNS may not work.\nWarning: %v\nSee https://docs.ddev.com/en/stable/users/usage/offline/ for info.", globalconfig.IsInternetActiveErr)
	}

	// We don't yet know the ComposeYaml values, so make sure they're
	// not set.
	app.ComposeYaml = nil

	// Set up ports to be replaced with ephemeral ports if needed
	app.RouterHTTPPort = app.GetPrimaryRouterHTTPPort()
	app.RouterHTTPSPort = app.GetPrimaryRouterHTTPSPort()
	app.MailpitHTTPPort = app.GetMailpitHTTPPort()
	app.MailpitHTTPSPort = app.GetMailpitHTTPSPort()
	app.XHGuiHTTPPort = app.GetXHGuiHTTPPort()
	app.XHGuiHTTPSPort = app.GetXHGuiHTTPSPort()

	AssignRouterPortsToGenericWebserverPorts(app)

	portsToCheck := []*string{&app.RouterHTTPPort, &app.RouterHTTPSPort, &app.MailpitHTTPPort, &app.MailpitHTTPSPort, &app.XHGuiHTTPPort, &app.XHGuiHTTPSPort}
	GetEphemeralPortsIfNeeded(portsToCheck, true)

	SyncGenericWebserverPortsWithRouterPorts(app)

	_ = app.DockerEnv()
	dockerutil.EnsureDdevNetwork()
	// The project network may have duplicates, we can remove them here.
	// See https://github.com/ddev/ddev/pull/5508
	dockerutil.RemoveNetworkDuplicates(app.GetDefaultNetworkName())

	if err = dockerutil.CheckDockerCompose(); err != nil {
		if os.IsTimeout(err) || strings.Contains(err.Error(), "timeout") {
			util.Failed(`Failed to download updated docker-compose binary.
This might be due to network issues or a slow response.
Please ensure your network is stable and try again:
%v`, err)
		} else {
			util.Failed(`DDEV's private docker-compose binary does not exist or is set to an invalid version.
Please use DDEV's' built-in docker-compose.
Fix with 'ddev config global --required-docker-compose-version="" --use-docker-compose-from-path=false': %v`, err)
		}
	}