🖥️ PC-Free: Linux Desktop en Docker via GitHub Codespace

🚀 Ejecuta un entorno de escritorio Linux completo desde la nube

Sin hardware potente • Sin instalaciones • Solo necesitas un navegador

🎯 ¿Qué es PC-Free?

PC-Free es una solución revolucionaria que te permite acceder a un escritorio Linux completo con KDE directamente desde tu navegador web, sin necesidad de:

🚫 Hardware potente local
🚫 Instalaciones complicadas
🚫 Configuraciones extensas
🚫 Mantenimiento de sistema

✨ Características principales

Característica	Descripción
🌐 Acceso web	Funciona 100% desde el navegador
🖥️ KDE Desktop	Escritorio completo con Ubuntu + KDE
🐳 Docker	Contenedorizado para máxima portabilidad
☁️ Cloud native	Optimizado para GitHub Codespaces
🔒 VNC integrado	Acceso remoto con cliente VNC
📱 Multi-plataforma	Funciona en cualquier dispositivo

⚠️ Requisito importante

🔐 ¡ATENCIÓN! Requisito obligatorio

Para que este proyecto funcione correctamente, debes seguir esta cuenta:

Algunas funcionalidades no se activarán si no cumples este requisito

📋 Requisitos del sistema

✅ Requisitos obligatorios

Componente	Requisito	Estado
🧑‍💻 GitHub Account	Cuenta activa con Codespaces	✅ Requerido
☁️ GitHub Codespaces	Habilitado en tu cuenta	✅ Requerido
🐋 Docker	Instalado y funcionando	✅ Requerido
🌐 Navegador Web	Chrome, Firefox, Safari, Edge	✅ Requerido

💾 Recursos recomendados

Recurso	Mínimo	Recomendado	Óptimo
🌐 Ancho de banda	4 Mbps	10 Mbps	15 Mbps+

⚙️ Instalación y configuración

🔧 Paso 1: Verificar espacio disponible

Antes de comenzar, verifica que tengas suficiente espacio:

df -h

💡 ¿Cómo interpretar la salida?

Busca líneas como estas:

/dev/sda1    10G  2.1G  7.4G  23% /
/tmp         5G   1.2G  3.8G  24% /tmp

Usa: La partición con más espacio libre (columna "Avail")
Recomendado: Al menos 4GB libres para mejor rendimiento

📁 Paso 2: Crear directorio para Docker

sudo mkdir -p /tmp/docker-data

💡 ¿Por qué este directorio? Docker necesita almacenar imágenes y contenedores. Al usar /tmp/docker-data, optimizamos el uso del espacio disponible.

⚙️ Paso 3: Configurar Docker

Edita el archivo de configuración de Docker:

sudo nano /etc/docker/daemon.json

Agrega exactamente este contenido:

{
  "data-root": "/tmp/docker-data",
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}

🤔 ¿Qué hace esta configuración?

data-root: Cambia donde Docker almacena sus datos
log-driver: Configura el formato de logs
log-opts: Limita el tamaño de logs para ahorrar espacio

🔄 Paso 4: Reiniciar servicios

# Reiniciar Docker para aplicar cambios
sudo systemctl restart docker

# Verificar que Docker funciona
sudo systemctl status docker

🧱 Configuración del contenedor

📄 Crear archivo `linux-desktop.yml`

📋 Ver archivo completo

# ⚠️ IMPORTANTE: Antes de ejecutar docker-compose up
# Asegúrate de seguir: https://github.com/jephersonRD
# 
# Ejecuta este script para verificar:
# bash check_github_follow.sh || exit 1

version: '3.8'

services:
  linux-desktop:
    image: linuxserver/webtop:ubuntu-kde
    container_name: linux-desktop
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=America/Santo_Domingo
      - KEYBOARD=en-us-qwerty
      - WEBPAGE_TITLE=Ubuntu KDE
      - RESOLUTION=1920x1080
      - SUDO_PASSWORD=123456
      - NOVNC_ENABLE=true
      - VNC_PASSWORD=vnc123456
    ports:
      - "3000:3000"
      - "5900:5900"
    volumes:
      - linux-data:/config
      - /dev/shm:/dev/shm
    cap_add:
      - SYS_ADMIN
    devices:
      - /dev/fuse
    security_opt:
      - seccomp:unconfined
    deploy:
      resources:
        limits:
          cpus: '4.0'
          memory: 16G
    restart: unless-stopped

volumes:
  linux-data:

🎛️ Variables de entorno personalizables

Variable	Valor por defecto	Descripción
`TZ`	`America/New_York`	Zona horaria
`KEYBOARD`	`en-us-qwerty`	Layout del teclado
`RESOLUTION`	`1920x1080`	Resolución de pantalla
`SUDO_PASSWORD`	`pcfree123`	Contraseña de sudo
`VNC_PASSWORD`	`vnc123456`	Contraseña VNC

🚀 Ejecución del sistema

▶️ Método 1: Inicio básico

# Descargar y ejecutar el contenedor
docker-compose -f linux-desktop.yml up -d

⚡ Método 2: Inicio con logs

# Ver logs en tiempo real durante el inicio
docker-compose -f linux-desktop.yml up

📊 Verificar que está funcionando

# Ver estado del contenedor
docker ps

# Ver logs
docker-compose -f linux-desktop.yml logs -f linux-desktop

🌐 Acceso al escritorio

🖥️ Opción 1: Navegador web (Recomendado)

Abre tu navegador
Ve a: http://localhost:3000
¡Disfruta tu escritorio Linux!

🎯 Consejos para mejor experiencia web

Chrome/Chromium: Mejor rendimiento general
Firefox: Buena compatibilidad, menos recursos
Safari: Funciona bien en Mac
Edge: Buena opción en Windows

Atajos útiles:

F11: Pantalla completa
Ctrl + Shift + I: Herramientas de desarrollador
Ctrl + F5: Recargar sin caché

🖱️ Opción 2: Cliente VNC

Configuración de conexión:

Host: localhost
Puerto: 5900
Contraseña: vnc123456

Clientes VNC recomendados:

Sistema	Cliente	Link
🪟 Windows	RealVNC Viewer	Descargar
🍎 macOS	Screen Sharing (built-in)	Aplicaciones → Utilidades
🐧 Linux	Remmina	`sudo apt install remmina`
📱 Android	VNC Viewer	Google Play Store
📱 iOS	VNC Viewer	App Store

🧯 Solución de problemas

❌ Problema: El contenedor no inicia

🔍 Diagnóstico:

# Ver logs detallados
docker-compose -f linux-desktop.yml logs

# Verificar espacio en disco
df -h

# Ver recursos del sistema
docker system df
free -h

✅ Soluciones:

Espacio insuficiente: Libera espacio con docker system prune -a
Permisos: Ejecutar con sudo si es necesario
Puerto ocupado: Cambiar puertos en el archivo yml

🐢 Problema: Rendimiento lento

🔍 Diagnóstico:

# Monitorear recursos
htop
docker stats

🧰 Herramientas y aplicaciones incluidas

📦 Software preinstalado

Categoría	Aplicaciones
🌐 Navegadores	Firefox, Chromium
📝 Editores	Kate, LibreOffice
🖼️ Multimedia	VLC, GIMP, Gwenview
💻 Desarrollo	VS Code, Git, Terminal
📁 Archivos	Dolphin File Manager
🎮 Sistema	System Settings, Task Manager

📦 Instalar software adicional

# Entrar al contenedor
docker exec -it linux-desktop-pcfree bash

# Actualizar paquetes
apt update && apt upgrade -y

# Instalar software adicional
apt install -y htop neofetch tree curl wget

🎨 Personalización del escritorio

Cambiar tema:

Click derecho en el escritorio → Configure Desktop
Appearance → Themes
Seleccionar tema deseado

Instalar íconos nuevos:

# Dentro del contenedor
apt install papirus-icon-theme

🤝 Contribuir al proyecto

🚀 Cómo contribuir

¡Tu ayuda es bienvenida! Aquí te explicamos cómo:

1. Fork del repositorio:

# Clonar tu fork
git clone https://github.com/tu-usuario/PC-Free.git
cd PC-Free

2. Crear rama para tu feature:

git checkout -b feature/mi-nueva-funcionalidad

3. Hacer cambios y commit:

# Hacer tus cambios...
git add .
git commit -m "feat: añadir nueva funcionalidad increíble"

4. Push y Pull Request:

git push origin feature/mi-nueva-funcionalidad
# Abrir PR en GitHub

🐛 Reportar bugs

Información necesaria para reportes:

🖥️ Sistema operativo
🐳 Versión de Docker
📋 Logs del contenedor
🔄 Pasos para reproducir

💡 Ideas para contribuir

📚 Mejorar documentación
🐛 Corregir bugs
✨ Añadir nuevas características
🎨 Mejorar la interfaz
⚡ Optimizaciones de rendimiento
🧪 Escribir tests

📚 Recursos adicionales

🔗 Enlaces útiles

Recurso	Descripción	Link
🐳 Docker Docs	Documentación oficial	docker.com
🖥️ LinuxServer.io	Imágenes Docker	linuxserver.io
☁️ GitHub Codespaces	Documentación	docs.github.com
🐧 KDE	Entorno de escritorio	kde.org

📖 Tutoriales recomendados

🎥 Docker para principiantes: YouTube Playlist
📚 Administración de Linux: Linux Journey
🔧 Configuración de VNC: Digital Ocean Guide

🆘 Obtener ayuda

Comunidades recomendadas:

📄 Licencia y términos

📜 Licencia MIT

MIT License

Copyright (c) 2024 PC-Free Project

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND...

⚖️ Términos de uso

✅ Uso personal y comercial permitido
✅ Modificación y distribución libre
✅ Sin garantía de funcionamiento
❌ No nos hacemos responsables de pérdidas de datos

🎉 ¡Disfruta tu PC-Free Desktop!

🌟 ¿Te gustó el proyecto?

💬 ¿Necesitas ayuda?

_{🧑‍💻 Diseñado para desarrolladores que necesitan un entorno Linux completo, sin depender de su hardware físico.

Creado con ❤️ por @jephersonRD •
Actualizado: Agosto 2024}

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

🖥️ PC-Free: Linux Desktop en Docker via GitHub Codespace

🚀 Ejecuta un entorno de escritorio Linux completo desde la nube

🎯 ¿Qué es PC-Free?

✨ Características principales

⚠️ Requisito importante

🔐 ¡ATENCIÓN! Requisito obligatorio

📋 Requisitos del sistema

✅ Requisitos obligatorios

💾 Recursos recomendados

⚙️ Instalación y configuración

🔧 Paso 1: Verificar espacio disponible

📁 Paso 2: Crear directorio para Docker

⚙️ Paso 3: Configurar Docker

🔄 Paso 4: Reiniciar servicios

🧱 Configuración del contenedor

📄 Crear archivo linux-desktop.yml

🎛️ Variables de entorno personalizables

🚀 Ejecución del sistema

▶️ Método 1: Inicio básico

⚡ Método 2: Inicio con logs

📊 Verificar que está funcionando

🌐 Acceso al escritorio

🖥️ Opción 1: Navegador web (Recomendado)

🖱️ Opción 2: Cliente VNC

🧯 Solución de problemas

❌ Problema: El contenedor no inicia

🐢 Problema: Rendimiento lento

🧰 Herramientas y aplicaciones incluidas

📦 Software preinstalado

📦 Instalar software adicional

🎨 Personalización del escritorio

🤝 Contribuir al proyecto

🚀 Cómo contribuir

🐛 Reportar bugs

💡 Ideas para contribuir

📚 Recursos adicionales

🔗 Enlaces útiles

📖 Tutoriales recomendados

🆘 Obtener ayuda

📄 Licencia y términos

📜 Licencia MIT

⚖️ Términos de uso

🎉 ¡Disfruta tu PC-Free Desktop!

🌟 ¿Te gustó el proyecto?

💬 ¿Necesitas ayuda?

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

📄 Crear archivo `linux-desktop.yml`

Packages