Skip to main content

Docker + Next

Crear Proyecto​

npx create-next-app@latest

Getting Started​

First, run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

🐳

Crear un Contenedor para el Proyecto

"next-container"

Crear archivo: Dockerfile en la raiz de tu proyecto​

Dockerfile

FROM node:alpine

WORKDIR /app

COPY package.json ./
COPY package-lock.json ./

RUN npm install --omit=dev

COPY . ./

RUN npm run build

EXPOSE 3000

CMD ["npm", "start"]

Crear archivo: package.json​

package.json

{
  "name": "docker-next",
  "version": "0.1.0",
  "private": true,
  "scripts": {
    "dev": "next dev --turbopack",
    "build": "next build",
    "start": "next start",
    "lint": "next lint"
  },
  "dependencies": {
    "react": "19.1.0",
    "react-dom": "19.1.0",
    "next": "15.4.5"
  },
  "devDependencies": {
    "typescript": "^5",
    "@types/node": "^20",
    "@types/react": "^19",
    "@types/react-dom": "^19",
    "@tailwindcss/postcss": "^4",
    "tailwindcss": "^4",
    "eslint": "^9",
    "eslint-config-next": "15.4.5",
    "@eslint/eslintrc": "^3"
  }
}

Crear archivo: .dockerignore​

.dockerignore

node_modules

Abre Terminal en VScode.​

Ejecuta estos comandos dentro de la carpeta del proyecto​

Crear imagen​

docker-next

wsl docker build -t docker-next .

Crear y correr contenedor​

next-container

wsl docker run -d --name next-container -p 4000:3000 docker-next

Ver imagenes​

wsl docker images

Ver contenedor​

wsl docker ps -a

Start contenedor​

wsl docker start next-container

Stop contenedor​

wsl docker stop next-container

Eliminar contenedor​

wsl docker rm next-container

Stop contenedor y Eliminar contenedor​

wsl docker stop next-container &&  wsl docker rm next-container

Eliminar imagen​

wsl docker rmi docker-next

Para crear y levantar el contenedor:​

En la terminal, desde la carpeta del proyecto, ejecuta: 
wsl docker run -d --name next-container -p 4000:3000 docker-next

Luego abre tu navegador y visita: http://localhost:4000​

🐧 Instalar Docker en Windows sin Docker Desktop, usando WSL2 y Ubuntu

✅ Requisitos previos​

Windows 10/11 actualizado

WSL2 activado

Ubuntu instalado desde Microsoft Store

¿Ya tienes WSL2 y Ubuntu instalado? Si no, te lo explico abajo. Si sí, pasa a la instalación de Docker.

🔧 PASO 1: Instalar WSL2 y Ubuntu​

1.1 Instala WSL con Ubuntu desde CMD o PowerShell:

wsl --install -d Ubuntu

Esto instala Ubuntu y configura WSL2 automáticamente. Luego reinicia tu PC si se te solicita.

🐳 PASO 2: Instalar Docker en Ubuntu (WSL2)​

Abre Ubuntu desde el menú Inicio.

Ejecuta estos comandos dentro de Ubuntu:​

# Actualizar el sistema
sudo apt update && sudo apt upgrade -y


# Instalar Docker

sudo apt install docker.io -y


# Habilitar el servicio de Docker
sudo service docker start

# Añadir tu usuario al grupo docker (para evitar usar sudo cada vez)

sudo usermod -aG docker $USER

Sal del terminal con exit, cierra Ubuntu y vuelve a abrirlo para aplicar los cambios de grupo.

✅ Verifica que Docker funciona​

Dentro de Ubuntu:​

docker --version
docker run hello-world

Si ves un mensaje de bienvenida, Docker está funcionando sin Docker Desktop

🎉

🧠 Opcional: Ejecutar Docker automáticamente al abrir Ubuntu​

Cada vez que abras Ubuntu, ejecuta:

sudo service docker start

Para automatizarlo:

echo "sudo service docker start" >> ~/.bashrc

Para ver si esta corriendo docker:

sudo service docker status

🎁 Beneficios​

tip

Mucho menos uso de CPU y RAM.

Cero uso de Docker Desktop.

Mejor integración con Linux-based dev tools.

Open https://localhost:3000 with your browser to see the result.

You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.