Instalar Kolibri

Advertencia

La versión final de **Kolibri ** aun no está publicada, por lo que ¡estas guías son trabajo en curso!

Para instalar Kolibri, es recomendable primero comprobar los requisitos del sistema y luego seguir con el procedimiento para el sistema operativo de tu dispositivo.

Requisitos del sistema

Sistemas operativos

Servidores

  • Windows
    • Supported: Vista, 7, 8, 10
    • Not supported: Windows XP cannot be used to install Kolibri server, but could potentially work as a client device if the browsers are as up-to-date as possible.
  • MacOS: 10.6+ (instalar el PEX)
  • Ubuntu: 14.04, 16.04 y más recientes - cualquiera que no esté discontinuado
  • Debian/Raspbian: Jessie o más reciente
  • Linux: cualquier sistema con Python 2.7
  • Android: not supported
  • iOS: not supported

Clientes

  • Windows: IE 11+, Chrome, Firefox
  • MacOS: todos los navegadores
  • Linux: todos los navegadores
  • Android: 4.2+
  • iOS: Safari not supported, Chrome & Firefox supported

Navegadores compatibles

  • IE11+, Microsoft Edge
  • Firefox
  • Chrome
  • (programado) Safari
  • (programado) Epiphany en Raspberry Pi
  • (programado) otros en Android y iOS.

Reproducción de vídeo

Vídeos están codificados como MP4 y no requieren ninguna instalación adicional de plugins o codecs.

Requerimientos de hardware

Truco

Below you will find general recommendations regarding hardware requirements. To read more detailed information and find out examples of hardware setups that have been implemented by our partners and users, download the full Kolibri Hardware Guide and examples of Hardware Configurations for Kolibri (PDF documents).

Servidores

Minimum hardware requirements to run Kolibri as a server:

  • 500 MB RAM (1 GB recomendado)
  • 500 MHz CPU (1 GHz recomendado)
  • Hard drive space depends on the size of the content channels you intend to import from Kolibri Studio or a local storage device.

Si el aula tiene menos de 30 computadoras, un dispositivo tan simple como Raspberry Pi se puede usar como el servidor.

Clientes

Ordenadores de sobremesa antiguos o de muy bajas prestaciones pueden utilizarse como clientes de Kolibri. Por ejemplo, algunas implementaciones utilizan dispositivos Raspberry Pi de primera generación como ordenadores de sobremesa.

Siempre es una buena idea hacer una prueba práctica, pero para implementar Kolibri, generalmente no es necesario actualizar el hardware. La principal preocupación es que el sistema tenga una tarjeta de vídeo y controladores que pueden reproducir los vídeos.

Windows

Para instalar o desinstalar Kolibri en Windows, seguir estos pasos.

Instalar

  1. Descargar el instalador de Kolibri para Windows.
  2. Hacer doble clic al archivo .exe descargado.
  3. Seleccionar el idioma a utilizar durante la instalación.
  4. Seguir las instrucciones en la ventana del asistente de instalación.
  5. Una vez terminada la instalación, Kolibri se Iniciará automáticamente y se abrirá en el navegador predeterminado de tu ordenador.
  6. Proceder con la Configuración inicial de la instalación.

Advertencia

Es probable que se abra el Firewall de Windows para pedir permisos del proceso de Python necesario para ejecutar Kolibri. Clicar Permitir acceso para aceptar y continuar.

Allow the Python process needed to run Kolibri.

Permitir el proceso de Python necesario para ejecutar Kolibri.

Desinstalar

  1. Abrir el Panel de Control de Windows.
  2. Seleccionar la opción Programas y características.
  3. Seleccionar Kolibri en la lista de programas.
  4. Clicar el botón Desinstalar y seguir las instrucciones.

Actualizar

Para actualizar Kolibri, seguir estos pasos.

  1. Descargar la nueva versión del instalador de Kolibri para Windows.
  2. Hacer doble clic al archivo .exe descargado.
  3. Seguir las instrucciones en la ventana del asistente de instalación.
  4. Una vez terminada la instalación de la actualización, Kolibri se Iniciará automáticamente y se abrirá en el navegador predeterminado de tu ordenador.
  5. ¡Ve y explora las nuevas y mejoradas características de Kolibri!

Debian/Ubuntu Linux

Advertencia

Ten en cuenta que el instalador final deb para Linux aun está en desarrollo, por lo cual puedes encontrar problemas al seguir los pasos indicados más abajo. Por favor, haz un informe de cualquier problema en el nuestro repositorio GitHub.

De todas maneras, puedes ejecutar Kolibri en el Terminal usando el paquete llamado PEX. Sigue el mismo procedimiento indicado para macOS.

Instalar desde el repositorio PPA

  1. Usa el siguiente comando en el Terminal para añadir PPA y instalar Kolibri.
sudo add-apt-repository ppa:learningequality/kolibri
sudo apt-get update
sudo apt-get install kolibri

O

  1. Ir a la página del proyecto Kolibri en Launchpad.
  2. Clicar para seleccionar el último paquete de la fuente. No importa cual, todos los archivos binarios son los mismos, independientemente de su arquitectura o la versión de Ubuntu/Debian.
  3. Desplazarse hacia abajo hasta Package files.
  4. Descargar el instalador de Kolibri (archivo DEB).
  5. Ejecutar el comando:
sudo dpkg -i kolibri-installer-filename.deb
  1. Esperar para que la instalación termine y ejecutar este comando para iniciar Kolibri:
kolibri start
  1. When command finishes, open the default browser at http://127.0.0.1:8080 and proceed with the Configuración inicial of your facility.

Desinstalar

  • Abrir Software en Ubuntu y buscar Kolibri. Pulsar el botón Desinstalar.

O

  • Usar sudo apt-get remove <nombre-del-paquete>. Necesitarás saber el nombre exacto del paquete instalado, probablemente kolibri.

Actualizar

TODO - Review

Para actualizar Kolibri, seguir estos pasos.

  1. Descargar la nueva versión de Kolibri.
  2. Iniciar al instalador.
  3. Una vez terminada la instalación de la actualización, Kolibri se Iniciará automáticamente y se abrirá en el navegador predeterminado de tu ordenador.
  4. ¡Ve y explora las nuevas y mejoradas características de Kolibri!

MacOS

Advertencia

Instalador final de macOS aún no está disponible, pero puedes ejecutar Kolibri en el Terminal utilizando el paquete llamado PEX.

Instalar

  1. Descargar el instalador PEX de Kolibri.
  2. Abrir Terminal en la carpeta donde se encuentra el PEX y ejecuta el siguiente comando:
chmod +x kolibri-installer-filename.pex
./kolibri-installer-filename.pex start
  1. Once the command finishes, open the default browser at http://127.0.0.1:8080 and proceed with the Configuración inicial of your facility.

Desinstalar

  1. Eliminar el archivo PEX.
  2. Delete the ./kolibri folder in your user’s Home directory if you want to completely remove all the Kolibri files and content channels you imported.

Actualizar

Para actualizar Kolibri, seguir estos pasos.

  1. Descargar la nueva versión del instalador PEX de Kolibri.
  2. Iniciar Kolibri como durante la primera instalación.
  3. ¡Ve y explora las nuevas y mejoradas características de Kolibri!

Android

Advertencia

¡Instalador final de Android aún no está disponible!

Instalar

  1. Permitir la instalación de Kolibri en tu dispositivo Android.

    Advertencia

    Esta versión beta del instalador de **Kolibri ** para Android aún no está disponible en Play Store, y para instalarlo es necesario cambiar una configuración de seguridad (estos pasos pueden variar dependiendo del modelo de dispositivo y versión de Android):

    1. Abre la aplicación Ajustes de tu dispositivo.
    2. Bajo Personal, toca Seguridad.
    3. Bajo Administrar dispositivo, toca Orígenes desconocidas.

  2. Descargar el instalador Kolibri para Android (APK file).

  3. Toca el archivo APK descargado.

  4. Espera que la instalación termine.

  5. Una vez que tengas Kolibri instalado, toca Abrir y proceder con la Configuración inicial de la instalación.

Advertencia

Be mindful of the size of content channels that you import on your Android phone or tablet, as some of them can quickly fill your device’s storage.

Desinstalar

  1. Abre la aplicación Ajustes de tu dispositivo.
  2. Bajo aplicaciones, toca Kolibri.
  3. Toca el botón Desinstalar.

Actualizar

Para actualizar Kolibri, seguir estos pasos.

  1. Desinstalar la versión anterior.
  2. Descargar la nueva versión de Kolibri.
  3. Toca el archivo APK descargado.
  4. Espera que la instalación termine.
  5. Toca Abrir y ¡explora las nuevas y mejoradas características de Kolibri!

Opciones de instalación avanzadas

Advertencia

Advanced installation options are in progress.

Instalación genérica (pip install)

Cuando Kolibri esté publicado, podrás instalarlo como un paquete estándar desde PyPi usando este comando:

$ pip install kolibri --pre

Debian/Ubuntu: Acceder a las actualizaciones por medio de PPA

Mantenemos un PPA en Launchpad y si estás conectado a internet, tendrás acceso a las actualizaciones automáticas.

On Ubuntu/Debian/Raspbian, do this:

sudo apt-get install software-properties-common python-software-properties
sudo add-apt-repository ppa:learningequality/kolibri
sudo apt-get update
sudo apt-get install kolibri

Raspberry Pi

Nota

This section is pending instructions for creating a WI-FI hotspot. You can install Kolibri on Raspbian following the above instructions for the PPA or the pip install method.

Configuración de Nginx

Nota

This section is pending instructions for NGINX configuration. You can install Kolibri on Raspbian following the above instructions for the PPA or the pip install method. If you are an experienced system administrator or Django user, know that it is possible to use Kolibri with for instance UWSGI+Nginx, using conventional methods.

Configuración inicial

Para hacer la configuración inicial de después de la instalación, seguir estos pasos.

Nota

Hay que hacer la configuración inicial sólo una vez, es decir la primera vez que inicias Kolibri después de la instalación.

  1. Selecciona el idioma predeterminado para Kolibri.

    Select the default Kolibri language.

    Selecciona el idioma predeterminado de Kolibri.

    Truco

    Puedes cambiar el idioma de la interfaz de usuario más tarde, desde el menú de usuario en la esquina superior derecha.

  2. Selecciona el nombre de tu Centro educativo. Centro educativo es la ubicación donde se instalará Kolibri - puede ser una escuela, centro de formación o sencillamente el nombre de tu familia.

    Select the name for the facility where Kolibri is running.

    Selecciona el nombre de tu instalación de Kolibri.

  3. Crear la cuenta de Administrador. Este administrador será un Superusuario capaz de administrar todo el contenido en el dispositivo, los usuarios de la instalación y sus permisos.

    Select the username and password for the facility Super User.

    Selecciona el nombre de usuario y contraseña para Superusuario.

  4. Selecciona el tipo de la instalación del Centro educativo. Clicar Detalles de configuración para obtener más información acerca de los permisos de usuario para cada tipo de instalación.

Tipo del Centro educativo Usuarios
Gestionado por Administrador
Para las escuelas y otros contextos de aprendizaje formal.
  • Administradores tienen que crear todas las cuentas de usuario.
  • Los usuarios pueden iniciar sesión sin contraseña.
  • Los usuarios no pueden editar la información de sus cuentas.
Auto-gestionado
Entre aprendizaje informal en familia, escolarización doméstica
o aprendizaje individual complementario.
  • Invitados pueden crear sus propias cuentas.
  • Los usuarios pueden editar la información de sus cuentas.
Uso personal o informal
Para bibliotecas, orfanatos, correccionales,
centros juveniles, aulas de ordenadores
y otros contextos de aprendizaje no formal.
  • Invitados pueden crear sus propias cuentas.
  • Los usuarios pueden editar la información de sus cuentas.
Choose a Facility setup.

Elegir una configuración del centro educativo.

View the Facility setup details.

Detalles de configuración del centro.

Una vez termine la configuración inicial, proceder a importar contenido y crear usuarios (si has elegido la configuración de instalación administrada por el administrador). Asegúrate de configurar otros equipos en la red a conectarse a Kolibri.

Release Notes

Changes are ordered reverse-chronologically.

0.7.2

  • Fix issue with importing large channels on Windows

0.7.1

  • Improvements and fixes to installers including Windows & Debian
  • Updated documentation

0.7.0

  • Completed RTL language support
  • Languages: English, Spanish, Arabic, Farsi, Swahili, Urdu, and French
  • Support for Python 3.6
  • Split user and developer documentation
  • Improved lost-connection and session timeout handling
  • Added “device info” administrator page
  • Content search integration with Studio
  • Granular content import and export

0.6.2

  • Consistent ordering of channels in learner views

0.6.1

  • Many mobile-friendly updates across the app
  • Update French, Portuguese, and Swahili translations
  • Upgraded Windows installer

0.6.0

  • Cross-channel searching and browsing
  • Improved device onboarding experience
  • Improved device permissions experience (deprecated “device owner”, added “superuser” flag and import permission)
  • Various channel import/export experience and stability improvements
  • Responsive login page
  • Dynamic language switching
  • Work on integrated living style guide
  • Added beta support for right-to-left languages
  • Improved handling of locale codes
  • Added support for frontend translation outside of Vue components
  • Added an open-source “code of conduct” for contributors
  • By default run PEX file in foreground on MacOS
  • Crypto optimizations from C extensions
  • Deprecated support for HTML in translation strings
  • Hide thumbnails from content “download” button
  • Automatic database backup during upgrades. #2365
  • … and many other updates and fixes

0.5.3

  • Release timeout bug fix from 0.4.8

0.5.2

  • Release bug fix from 0.4.7

0.5.1

  • Python dependencies: Only bundle, do not install dependencies in system env #2299
  • Beta Android support
  • Fix “importchannel” command #2082
  • Small translation improvements for Spanish, French, Hindi, and Swahili

0.5.0

  • Update all user logging related timestamps to a custom datetime field that includes timezone info
  • Added daemon mode (system service) to run kolibri start in background (default!) #1548
  • Implemented kolibri stop and kolibri status #1548
  • Newly imported channels are given a “last_updated” timestamp
  • Add progress annotation for topics, lazily loaded to increase page load performance
  • Add API endpoint for getting number and total size of files in a channel
  • Migrate all JS linting to prettier rather than eslint
  • Merge audio_mp3_render and video_mp4_render plugins into one single media_player plugin
  • KOLIBRI_LISTEN_PORT environment variable for specifying a default for the –port option #1724

0.4.9

  • User experience improvements for session timeout

0.4.8

  • Prevent session timeout if user is still active
  • Fix exam completion timestamp bug
  • Prevent exercise attempt logging crosstalk bug
  • Update Hindi translations

0.4.7

  • Fix bug that made updating existing Django models from the frontend impossible

0.4.6

  • Fix various exam and progress tracking issues
  • Add automatic sign-out when browser is closed
  • Fix search issue
  • Learner UI updates
  • Updated Hindi translations

0.4.5

  • Frontend and backend changes to increase performance of the Kolibri application under heavy load
  • Fix bug in frontend simplified login code

0.4.4

  • Fix for Python 3 compatibility in Whl, Windows and Pex builds #1797
  • Adds Mexican Spanish as an interface language
  • Upgrades django-q for bug fixes

0.4.3

  • Speed improvements for content recommendation #1798

0.4.2

  • Fixes for morango database migrations

0.4.1

  • Makes usernames for login case insensitive #1733
  • Fixes various issues with exercise rendering #1757
  • Removes wrong CLI usage instructions #1742

0.4.0

  • Class and group management
  • Learner reports #1464
  • Performance optimizations #1499
  • Anonymous exercises fixed #1466
  • Integrated Morango, to prep for data syncing (will require fresh database)
  • Adds Simplified Login support as a configurable facility flag

0.3.3

  • Turns video captions on by default

0.3.2

  • Updated translations for Portuguese and Kiswahili in exercises.
  • Updated Spanish translations

0.3.2

  • Portuguese and Kaswihili updates
  • Windows fixes (mimetypes and modified time)
  • VF sidebar translations

0.3.0

  • Add support for nested URL structures in API Resource layer
  • Add Spanish and Swahili translations
  • Improve pipeline for translating plugins
  • Add search back in
  • Content Renderers use explicit new API rather than event-based loading

0.2.0

  • Add authentication for tasks API
  • Temporarily remove “search” functionality
  • Rename “Learn/Explore” to “Recommended/Topics”
  • Add JS-based “responsive mixin” as alternative to media queries
  • Replace jeet grids with pure.css grids
  • Begin using some keen-ui components
  • Update primary layout and navigation
  • New log-in page
  • User sign-up and profile-editing functionality
  • Versioning based on git tags
  • Client heartbeat for usage tracking
  • Allow plugins to override core components
  • Wrap all user-facing strings for I18N
  • Log filtering based on users and collections
  • Improved docs
  • Pin dependencies with Yarn
  • ES2015 transpilation now Bublé instead of Babel
  • Webpack build process compatible with plugins outside the kolibri directory
  • Vue2 refactor
  • HTML5 app renderer

0.1.1

  • SVG inlining
  • Exercise completion visualization
  • Perseus exercise renderer
  • Coach reports

0.1.0 - MVP

  • Improved documentation
  • Conditional (cancelable) JS promises
  • Asset bundling performance improvements
  • Endpoint indexing into zip files
  • Case-insensitive usernames
  • Make plugins more self-contained
  • Client-side router bug fixes
  • Resource layer smart cache busting
  • Loading “spinner”
  • Make modals accessible
  • Fuzzy searching
  • Usage data export
  • Drive enumeration
  • Content interaction logging
  • I18N string extraction
  • Channel switching bug fixes
  • Modal popups
  • A11Y updates
  • Tab focus highlights
  • Learn app styling changes
  • User management UI
  • Task management
  • Content import/export
  • Session state and login widget
  • Channel switching
  • Setup wizard plugin
  • Documentation updates
  • Content downloading

0.0.1 - MMVP

  • Page titles
  • Javascript logging module
  • Responsiveness updates
  • A11Y updates
  • Cherrypy server
  • Vuex integration
  • Stylus/Jeet-based grids
  • Support for multiple content DBs
  • API resource retrieval and caching
  • Content recommendation endpoints
  • Client-side routing
  • Content search
  • Video, Document, and MP3 content renderers
  • Initial VueIntl integration
  • User management API
  • Vue.js integration
  • Learn app and content browsing
  • Content endpoints
  • Inclusión automática de requerimientos en una build estática
  • Django JS Reverse with urls representation in kolibriGlobal object
  • Python plugin API with hooks
  • Webpack build pipeline, including linting
  • Authentication, authorization, permissions
  • Users, Collections, and Roles