Cómo instalar Ourschool en Docker - Gestor de homeschool autohospedado en Docker

Ourschool | Homeschool Management | Docker

Ourschool: Gestor de homeschooling autohospedado en Docker

Plataforma para familias homeschooling. Asistencia, calificaciones, tareas, reportes. Multi-usuario (padres/alumnos). Gamificación. Django + PostgreSQL. Open source. Self-hosted completo.

¿Qué es Ourschool?


Ourschool es una plataforma de gestión de homeschooling completamente gratuita y open source diseñada para familias que enseñan en casa. Maneja el lado administrativo — asistencia, calificaciones, tareas, reportes, progreso — para que los padres puedan enfocarse en la enseñanza real.

Diferenciador clave: Está hecho POR gente que hace homeschooling PARA gente que hace homeschooling. No es una solución educativa genérica. Es específica para familias que toman en serio la asistencia, calificación cuidadosa de asignaciones, y documentación.

Características principales: Tracking de asistencia diario con status y notas. Gestión de materias/subjects con descripción y fecha inicio/fin. Asignaciones con descripción, fecha vencimiento, calificaciones, comentarios. Reportes con exportación. Sistema de puntos gamificado (motivar estudiantes). Multi-usuario: padres (admin) ven todo; estudiantes ven solo su progreso. Autenticación separada. Respuestas automáticas en primer inicio (migración + seed admin account). Backup/restore integrado con preview dry-run. Dashboard por rol. Django (Python) + PostgreSQL + Vite frontend. Beta estable (v1.0.0-beta). Planned stable release 2026-2027.

Para familias homeschooling: Un solo lugar para toda la documentación administrativa. Padres controlan, estudiantes ven progreso. Sin spreadsheets. Sin apps externas.

Características principales

Asistencia diaria

Log de presencia con status (presente/ausente/etc) y notas. Histórico completo.

Gestión de materias

Define subjects, fechas, descripción. Organiza curriculum.

Asignaciones

Crear, asignar fecha vencimiento, calificar, comentarios. Tracking.

Calificaciones

Numérico, letras, o custom. Cálculo automático promedio.

Reportes

Progreso académico. Exportable (PDF/CSV). Documentación.

Gamificación

Sistema de puntos. Motivar estudiantes. Logros, badges, rewards.

Multi-usuario

Roles: Padres (admin), Estudiantes (viewer). Auth separada.

Dashboard por rol

Padres ven ALL. Estudiantes ven solo THEIR progress + grades.

Backup/Restore

Sistema integrado. Dry-run preview antes de restore. Seguro.

Responsive

Desktop, tablet, móvil. Interface amigable.

Open source

Código abierto. Customizable. Libre de vendor lock-in.

Self-hosted

Control total. Datos 100% tuyos. Sin SaaS.

Estado del proyecto (importante)

Beta en desarrollo: Ourschool es v1.0.0-beta.5. Pre-estable. El schema de base de datos PUEDE tener cambios breaking hasta la planned stable release (2026–2027). Usa el sistema integrado backup/restore (con dry-run preview) para salvaguardar datos entre updates. OK para production homeschooling siempre y cuando hagas backups regulares.

Requisitos del sistema

  • Docker & Docker Compose
  • 1-2 GB RAM (Django + PostgreSQL)
  • 5+ GB espacio disco (BD + archivos)
  • Puerto 4173 (o custom en Caddy)
  • PostgreSQL (incluido en docker-compose, o externo)
  • SECRET_KEY (generado via openssl)
  • Navegador moderno
Setup rápido: 4 pasos. Download compose, .env, generate SECRET_KEY, docker compose up. Listo.

Instalación con Docker Compose (4 pasos)

Paso 1: Descargar archivos

mkdir ourschool && cd ourschool curl -O https://raw.githubusercontent.com/DGAzr/ourschool/main/docker-compose.ghcr.yml curl -O https://raw.githubusercontent.com/DGAzr/ourschool/main/env.EXAMPLE

Paso 2: Configurar .env

cp env.EXAMPLE .env # Generar SECRET_KEY fuerte openssl rand -hex 32 # Copia el resultado y edita .env nano .env # Reemplaza SECRET_KEY = [resultado arriba] # Cambiar DATABASE_URL si usas DB externa

Paso 3: Iniciar con BD local (incluida)

docker compose -f docker-compose.ghcr.yml --profile local-db up -d # Espera 30-60 segundos # Backend auto-migra y seed admin account

Paso 4: Acceder

http://localhost:4173 - Dashboard Ourschool

Primer login (CAMBIAR INMEDIATAMENTE!)

  • Usuario: admin
  • Contraseña: admin123
  • ⚠️ CAMBIAR CONTRASEÑA INMEDIATAMENTE después de login. Credenciales default son público.

Si usas BD externa

# Omitir --profile local-db docker compose -f docker-compose.ghcr.yml up -d # DATABASE_URL en .env debe apuntar a tu PostgreSQL

Primeros pasos

1. Cambiar contraseña admin

  1. Login con admin / admin123
  2. Settings → Change Password
  3. Actualiza a contraseña fuerte
  4. Save

2. Crear estudiantes

  1. Dashboard → Students / Add Student
  2. Nombre, edad, grado (opcional)
  3. Crear cuenta de login para cada estudiante (auto-genera user/password)
  4. Comparte credenciales con ellos

3. Crear materias/subjects

  1. Dashboard → Subjects / Add Subject
  2. Nombre: "Matemáticas", "Historia", "Biología"
  3. Descripción (opcional)
  4. Fecha inicio/fin
  5. Save

4. Registrar asistencia

  1. Dashboard → Attendance
  2. Selecciona fecha y estudiante
  3. Status: Present, Absent, Sick, Tardy, etc
  4. Notas (opcional)
  5. Save

5. Crear asignaciones

  1. Dashboard → Assignments / New Assignment
  2. Título: "Capítulo 5 Matemáticas"
  3. Descripción: "Problemas 1-50 página 120"
  4. Subject: Selecciona materia
  5. Fecha vencimiento
  6. Asigna a estudiante(s)

6. Calificar asignaciones

  1. Dashboard → Assignments → select assignment
  2. Ver submissions de estudiantes
  3. Calificar: numérico o comentarios
  4. Comentarios/feedback
  5. Marcar como "Graded"

7. Ver reportes

  1. Dashboard → Reports
  2. Progreso por estudiante
  3. Promedio de calificaciones
  4. Exportar (PDF/CSV)

8. Sistema de puntos (gamificación)

  1. Dashboard → Rewards / Points System
  2. Asigna puntos por tareas completadas
  3. Estudiantes ven su progreso/badges
  4. Motivación integrada

Casos de uso

  • Familias homeschooling: Documentación administrativa. Cumplimiento legal. Registros.
  • Tutorías privadas: Track de estudiantes, asignaciones, progreso.
  • Pequeñas escuelas alternativas: Alternativa a sistemas SaaS caros.
  • Microschools: Ambiente familiar con estructura adminstrativa.
  • Co-op learning groups: Coordinación entre familias que comparten teaching.

HTTPS con Caddy (producción)

Caddyfile

school.tudominio.com { reverse_proxy localhost:4173 }

Acceso remoto seguro

https://school.tudominio.com con HTTPS automático

Estudiantes acceden remotamente

Desde cualquier dispositivo/ubicación: https://school.tudominio.com. Login y ven su dashboard.

Gestión y mantenimiento

Ver logs

docker compose logs -f

Backup integrado

Ourschool incluye sistema backup/restore en UI. Dashboard → Settings → Backup.

Backup manual BD

docker compose exec postgres pg_dump -U ourschool -d ourschool > ourschool-$(date +%Y%m%d).sql

Restore de backup

docker compose exec -i postgres psql -U ourschool -d ourschool < ourschool-20260522.sql

Reiniciar

docker compose restart

Actualizar a versión más reciente

docker compose pull docker compose up -d # Migraciones BD se aplican automáticamente

Monitorear consumo

docker stats

Comparativa con alternativas

vs Google Classroom / Microsoft Teams

Ourschool gana: Self-hosted, específico homeschooling, privado. Classroom gana: Integración ecosystem, más features.

vs Schoology / Canvas

Ourschool gana: Gratis, self-hosted, simple. Canvas gana: Enterprise, más features, soporte.

vs Spreadsheet (Excel/Sheets)

Ourschool gana: Interfaz bonita, multi-usuario, seguridad. Sheets gana: Flexibility total.

Mejor para: Familias homeschooling que quieren documentación simple, self-hosted, gratis. Específicamente diseñado para homeschool.

Referencias oficiales

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Sígueme en mis redes sociales

Telegram Discord YouTube GitHub Blog Twitter

Comentarios

Publicar un comentario

Comenta...

Entradas populares de este blog

NAS SYNOLOGY DSM 7.1 en VMware ESXI - Guía instalación y configuración Synology DSM 7.1 en VMWARE

Imagen
"NAS Synology en VMware - Guía instalación y configuración Synology DSM 7.1" Descarga los ficheros desde este enlace: https://mega.nz/file/ZTwnGaKQ#HreeTekfsAFJhCMQmoGKG4AooZXE8_3xPcTrgRgwV_U Contraseña: bilaljebari Vídeo del proceso explicado paso a paso. ⏭📼 https://www.youtube.com/@genbyte?sub_confirmation=1 👍❤️🔔 Apoya mi canal. Suscríbete y activa la campana para recibir los últimos vídeos. Otros vídeos Instalación VMWare ESXI https://www.youtube.com/watch?v=8VXg78ayPAQ Instalación NAS Synology en PC/Servidor https://www.youtube.com/watch?v=CBGxjHVyBq8
Leer más

Solución al error: «user is not in the sudoers file» en Debian

Imagen
  Solución al error: «user is not in the sudoers file» en Debian Acabas de instalar Debian, abres la terminal para actualizar el sistema con: sudo apt update y, de repente, aparece el siguiente error: user is not in the sudoers file. This incident will be reported. Si es tu primera vez con Debian seguramente pienses:  “¿Qué he hecho mal?” . Tranquilo, no es culpa tuya. Este problema es bastante habitual en Debian porque, a diferencia de Ubuntu, el primer usuario creado durante la instalación no siempre se añade automáticamente al grupo  sudo . La buena noticia es que la solución es muy sencilla. ¿Por qué aparece este error en Debian? El error indica que tu usuario actual no tiene permisos para ejecutar comandos como administrador. En Debian, esos permisos se gestionan a través del archivo  /etc/sudoers  o mediante el grupo  sudo . 👉 En resumen: tu usuario no está autorizado para usar  sudo , pero el sistema funciona perfectamente. Solución paso a...
Leer más

Comando "NET USE", uso, parámetros y algunos ejemplos de uso

Imagen
   Introducción   El comando " net use " nos sirve para gestionar las conexiones a recursos compartidos y para mostrar información de las conexiones de Red existentes en nuestro equipo.         Parámetros   · ninguno: Escriba net use sin parámetros para obtener una lista de las conexiones de red.   · nombre_dispositivo: Asigna un nombre para la conexión al recurso o especifica el dispositivo que se va a desconectar. Hay dos tipos de nombres de dispositivos: Unidades de disco (D a Z) e impresoras (LPT1 a LPT3). Escriba un asterisco en lugar de un nombre específico de dispositivo para asignar el siguiente nombre de dispositivo disponible.   · \\nombre_equipo\recurso_compartido: Es el nombre del servidor y del recurso compartido. Si el nombre de equipo contiene caracteres en blanco, escriba la barra invertida doble (\\) y el nombre entre comillas (" "). El nombre de equipo puede tener entre 1 y 15 caracteres.   · \volumen: Especifica u...
Leer más