En esta página

Paquetes Enterprise Qt de Debian

Para utilizar los paquetes Enterprise de Debian con Qt, añade tus repositorios Enterprise a la Herramienta Avanzada de Paquetes (APT). Para más detalles, consulta el Formato de configuración de los repositorios de Debian.

Para utilizar los repositorios de empresa, debes:

Nota: Para obtener más detalles y asistencia,ponte en contacto con nosotros. Para obtener más información sobre las pruebas gratuitas, consulta Pruebas gratuitas del software Qt.

Formato de configuración del repositorio de Debian

Para añadir repositorios adicionales para APT, inserte los repositorios en un archivo con la extensión .list en el directorio /etc/apt/sources.list.d. Añada una nueva entrada en el archivo para cada repositorio. El formato genérico es el siguiente:

deb [arch=<arch> signed-by=<path>] <REPO_URL> <DIST> <COMPONENT(s)>

Un ejemplo de entrada de un repositorio empresarial:

$ sudo nano /etc/apt/sources.list.d/tqtc.list

    deb [arch=arm64 signed-by=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-arm64 tqtc-jammy main

Consulte la información sobre repositorios para las versiones de Qt para obtener información detallada sobre cómo configurar los repositorios según la versión y la arquitectura de Qt.

Paquetes fuente de Debian

Para añadir los paquetes fuente de Debian a APT, debes añadir una entrada «deb-src» correspondiente a la entrada «deb» correspondiente:

$ sudo nano /etc/apt/sources.list.d/tqtc.list

    deb [arch=arm64 signed-by=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-arm64 tqtc-jammy main
    deb-src [signed-by=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-arm64 tqtc-jammy main

Para descargar paquetes fuente (por ejemplo, para Wayland) al directorio actual, utiliza el comando « apt source »:

$ sudo apt source qt-6.12.0-wayland-src

Instalación de una clave GPG pública

Instala una clave pública GPG (GNU Privacy Guard) para los repositorios de Enterprise Qt en Debian de la siguiente manera:

$ sudo mkdir -p /etc/apt/keyrings/tqtc  # Create the directory with appropriate permissions
$ cd /etc/apt/keyrings/tqtc
$ sudo wget https://cdn.qt.io/debian/keys/qt-company-debian-repo.gpg

Configuración de la autenticación

Para acceder a los repositorios indicados, necesitas una cuenta de Enterprise Qt o una cuenta de evaluación de Qt.

Nota: Si tu contraseña contiene caracteres especiales, es posible que tengas que escaparlos utilizando «\» o «%40».

Configura las credenciales de la cuenta de Qt para tu gestor de paquetes APT de la siguiente manera:

$ sudo nano /etc/apt/auth.conf

      machine https://debian-packages.qt.io
      login <Qt Account login name (email)>
      password <Qt Account password>

Advertencia: Este archivo puede contener información confidencial. Para evitar que otros usuarios del sistema puedan leer la contraseña, asegúrate de que el archivo tenga permisos estrictos:

$ sudo chmod 600 /etc/apt/auth.conf

Actualización de la caché local de paquetes

Actualiza la caché local de paquetes de la siguiente manera:

$ sudo apt-get update

En la salida no debería aparecer ningún error relacionado con el repositorio añadido.

Paquetes alias de Debian

Puede instalar el contenido más fácilmente con paquetes alias, que no son más que metapaquetes que apuntan a los paquetes reales de Debian.

El contenido de los paquetes alias de Debian se detalla en la tabla siguiente.

Nota: En los ejemplos de paquetes alias que se enumeran a continuación se utiliza la versión 6.12.0de Qt . Recuerda siempre utilizar los paquetes que correspondan a la versión de Qt con la que estés trabajando. Para obtener más información, consulta la información del repositorio para las versiones de Qt.

Nombre del paquete aliasContenido del paquete
qt6.12.0-essentials
qt6.12.0-essentials-dev
  • bibliotecas de módulos esenciales
  • cabeceras de los módulos esenciales
  • Cabeceras privadas de los módulos esenciales
  • herramientas de tiempo de ejecución del módulo esencial
  • herramientas de desarrollo de módulos esenciales
qt6.12.0-full
qt6.12.0-full-dev
  • todas las bibliotecas de módulos
  • Todos los encabezados de los módulos
  • Todos los encabezados privados de los módulos
  • todas las herramientas de tiempo de ejecución de los módulos
  • todas las herramientas de desarrollo de módulos
qt6.12.0-full-dbg

Ejemplo de comando de instalación de Debian

$ sudo apt install qt6.12.0-full-dev

Ejemplo de configuración completa

El siguiente fragmento de código muestra el flujo de trabajo completo con los paquetes Enterprise Qt para Debian:

 # install repository key
 $ sudo mkdir -p /etc/apt/keyrings/tqtc
 $ cd /etc/apt/keyrings/tqtc
 $ sudo wget https://cdn.qt.io/debian/keys/qt-company-debian-repo.gpg

 # configure Qt Account based authentication to Qt Debian repositories
 $ sudo nano /etc/apt/auth.conf
   machine https://debian-packages.qt.io
   login <your Qt Account email>
   password <your Qt Account password>

 # add repositories
 $ sudo nano /etc/apt/sources.list.d/tqtc.list
     deb [arch=arm64 signed-by=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt6.12.0-arm64 tqtc-jammy main

 # add source packages
 $ sudo nano /etc/apt/sources.list.d/tqtc.list
     deb-src [signed-by=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-arm64 tqtc-jammy main

 # update local package cache
 $ sudo apt-get update

 # search and install packages
 $ apt-cache search qt6.12.0-full-dev
 ....
 ....
 # files are installed under /opt/qt-6.12.0
$ sudo apt install qt6.12.0-full-dev

Consulta la información sobre los repositorios de las versiones de Qt para seleccionar los repositorios necesarios y añadirlos a tu archivo /etc/apt/sources.list.d/tqtc.list.

Solución de problemas

Dificultades en la autenticación

El servidor puede responder con los siguientes códigos de error HTTP:

401 No autorizado

Credenciales incorrectas. El correo electrónico y la contraseña del usuario deben introducirse en el formato correcto.

Además, prueba a almacenar las credenciales directamente en la configuración del repositorio:

deb [...] https://<Qt Account email>:<Qt Account passwd>@https://debian-packages.qt.io/.....

Si tu contraseña contiene caracteres especiales, es posible que tengas que escapar esos caracteres para APT. Utiliza '' o '%40' para escapar esos caracteres o prueba a cambiar la contraseña de tu cuenta de Qt.

403 Prohibido

Faltan las credenciales.

429 Demasiadas solicitudes

El usuario ha enviado demasiadas solicitudes fallidas (3 solicitudes por minuto).

500 Error interno del servidor

Póngase en contacto con el servicio de asistencia de Qt.

Problemas con el uso de la clave GPG del repositorio

Una alternativa al atributo de uso « signed-by » en la configuración del repositorio es instalar la clave de la siguiente manera, aunque no se recomienda, ya que se trata de un método obsoleto:

$ sudo apt-key add qt-company-debian-repo.gpg

Información del repositorio para las versiones de Qt

A continuación encontrarás las versiones de Qt compatibles con los paquetes Enterprise Qt para Debian. Selecciona los repositorios necesarios y añádelos a tu archivo /etc/apt/sources.list.d/tqtc.list tal y como se indica más arriba.

Además, en las siguientes tablas se enumeran los directorios de instalación en su sistema y las distribuciones de Linux compatibles con los paquetes.

Nota: Para acceder a los repositorios indicados, necesitas una cuenta Qt de evaluación o una cuenta Qt comercial con una licencia de Qt for Device Creation.

Nota: Es posible quelos paquetes funcionen también en otras distribuciones, pero no hay garantía al respecto.

Qt Creator

ArquitecturaDistribuciónDirectorio de instalaciónEntradas de la lista de recursos de paquetes para APT
amd64jammy-jellyfish (Ubuntu 22.04)/opt/qt-creator/deb [arch=amd64 signed-by=<ruta>] https://debian-packages.qt.io/debian/enterprise/qtcreator-amd64 tqtc-jammy main
arm64jammy-jellyfish (Ubuntu 22.04)/opt/qt-creator/deb [arch=arm64 signed-by=<ruta>] https://debian-packages.qt.io/debian/enterprise/qtcreator-arm64 tqtc-jammy main

Qt 6.12.0

ArquitecturaDistribuciónDirectorio de instalaciónEntradas de la lista de recursos de paquetes para APT
amd64jammy-jellyfish (Ubuntu 22.04)/opt/qt-6.12.0/x86_64-linux-gnu/deb [arch=amd64 signed-by=<path>] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-amd64 tqtc-jammy main
arm64jammy-jellyfish (Ubuntu 22.04)/opt/qt-6.12.0/aarch64-linux-gnu/deb [arch=arm64 signed-by=<ruta>] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-arm64 tqtc-jammy main
arm64bookworm (Debian 12, GLES)/opt/qt-6.12.0/aarch64-linux-gnu/deb [arch=arm64 signed-by=<ruta>] https://debian-packages.qt.io/debian/enterprise/qt-6.12.0-arm64-gles tqtc-bookworm main

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.