Function runDockerContainer

frontend/src/app/api/runProject/route.ts:323–465

* Run Docker container using the base image

(
  projectPath: string
)

 * Run Docker container using the base image
 */
async function runDockerContainer(
  projectPath: string
): Promise<{ domain: string; containerId: string; port: number }> {
  const traefikDomain = process.env.TRAEFIK_DOMAIN || 'docker.localhost';

  // Check for existing container
  const existingContainerId = await checkExistingContainer(projectPath);
  if (existingContainerId) {
    // Verify container is running
    const isRunning = await checkContainerRunning(existingContainerId);
    if (isRunning) {
      const subdomain = projectPath.replace(/[^\w-]/g, '').toLowerCase();
      const domain = `${subdomain}.${traefikDomain}`;
      const containerInfo = runningContainers.get(projectPath);
      const port = containerInfo?.port || 0;

      // Update container state
      runningContainers.set(projectPath, {
        domain,
        containerId: existingContainerId,
        port,
        timestamp: Date.now(),
      });
      await saveState();

      return { domain, containerId: existingContainerId, port };
    }

    // If container is no longer running, try to remove it
    try {
      await execWithTimeout(`docker rm -f ${existingContainerId}`, {
        timeout: 30000,
      });
      logger.info(`Removed non-running container: ${existingContainerId}`);
    } catch (error) {
      logger.error(`Error removing non-running container:`, error);
      // Continue processing even if removal fails
    }
  }

  // Ensure base image exists
  await ensureBaseImageExists();

  const directory = path.join(getProjectPath(projectPath), 'frontend');
  const subdomain = projectPath.replace(/[^\w-]/g, '').toLowerCase();
  const containerName = `container-${subdomain}`;
  const domain = `${subdomain}.${traefikDomain}`;

  // Allocate port
  const exposedPort = await findAvailablePort();

  try {
    // Check if a container with the same name already exists, remove it if found
    try {
      await execWithTimeout(`docker inspect ${containerName}`, {
        timeout: 10000,
      });
      logger.info(