FlowFiles.ContainerNotRunning

FlowFiles.ContainerNotRunning

Error message

container '%s' is not running; start the flow before pulling files

What it means

Error "container '%s' is not running; start the flow before pulling files" thrown in vxcontrol/pentagi.

Source

Thrown at backend/pkg/server/services/flow_files.go:741

	if s.dockerClient == nil {
		err = errors.New("docker client not configured on this server")
		logger.FromContext(c).WithError(err).WithField("flow_id", flowID).Error("docker client unavailable for pull")
		response.Error(c, response.ErrInternal, err)
		return
	}

	containerName := primaryContainerName(s.tenantPrefix, flowID)
	running, err := s.dockerClient.IsContainerRunning(c.Request.Context(), containerName)
	if err != nil {
		logger.FromContext(c).WithError(err).WithFields(map[string]any{
			"flow_id":        flowID,
			"container_name": containerName,
		}).Error("error checking container status for pull")
		response.Error(c, response.ErrInternal, err)
		return
	}
	if !running {
		err = fmt.Errorf("container '%s' is not running; start the flow before pulling files", containerName)
		logger.FromContext(c).WithError(err).WithField("flow_id", flowID).Error("container not running for pull")
		response.Error(c, response.ErrFlowFilesContainerNotRunning, err)
		return
	}

	// ── Phase 2: pull each validated entry from the container ─────────────────
	syncedFiles := make([]models.FlowFile, 0, len(entries))
	addedFiles := make([]models.FlowFile, 0, len(entries))
	updatedFiles := make([]models.FlowFile, 0)

	for _, entry := range entries {
		reader, _, err := s.dockerClient.CopyFromContainer(c.Request.Context(), containerName, entry.containerPath)
		if err != nil {
			logger.FromContext(c).WithError(err).WithFields(map[string]any{
				"flow_id":        flowID,
				"container_path": entry.containerPath,
			}).Error("error copying from container")
			response.Error(c, response.ErrInternal, err)

View on GitHub (pinned to ea665308ba)

When it happens

Trigger: Thrown at backend/pkg/server/services/flow_files.go:741 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of vxcontrol/pentagi@ea665308ba (2026-09-01). Data as JSON: /api/errors/0ca7923b082c62b6. Report an issue: GitHub.