Method Pause

pkg/ddevapp/ddevapp.go:2952–3006

Pause initiates docker-compose stop

()

// Pause initiates docker-compose stop
func (app *DdevApp) Pause() error {
	_ = app.DockerEnv()

	status, _ := app.SiteStatus()
	if status == SiteStopped {
		return nil
	}

	err := app.ProcessHooks("pre-pause")
	if err != nil {
		return err
	}

	_ = SyncAndPauseMutagenSession(app)

	if _, _, err := dockerutil.ComposeCmd(&dockerutil.ComposeCmdOpts{
		ComposeFiles: []string{app.DockerComposeFullRenderedYAMLPath()},
		Profiles:     []string{`*`},
		Action:       []string{"stop"},
	}); err != nil {
		return err
	}

	// Wait for containers to fully transition to exited state
	// This prevents race conditions where SiteStatus() might return "unhealthy"
	// instead of "paused" when checked immediately after Pause() returns
	// Poll for up to 5 seconds with 100ms intervals
	maxAttempts := 50
	for range maxAttempts {
		containers, err := dockerutil.GetAppContainers(app.Name)
		if err != nil {
			// If we can't get containers, assume they're stopped
			break
		}

		allExited := true
		for _, c := range containers {
			if c.State != container.StateExited {
				allExited = false
				break
			}
		}
		if allExited {
			break
		}
		time.Sleep(100 * time.Millisecond)
	}

	err = app.ProcessHooks("post-pause")
	if err != nil {
		return err
	}

	return nil
}

// WaitForServices waits for all the services in docker-compose to come up
func (app *DdevApp) WaitForServices() error {