Autofirma no se abre en Linux: Ubuntu, Mint y Debian

Autofirma está instalada —el paquete .deb o .rpm terminó sin quejarse— y aun así no se abre: ni desde el menú de aplicaciones ni cuando la sede la llama. En Linux este síntoma casi nunca es un misterio, porque la aplicación imprime la causa exacta si sabes dónde mirar. Esta guía recorre las cuatro causas reales por orden de frecuencia, con el comando que confirma cada una. Si todavía no la has instalado, empieza por Instalar Autofirma en Linux; si el problema es en Windows o Mac, o no sabes aún si es de instalación o de comunicación, el mapa general está en Autofirma no se abre o se cierra sola.

Primero: lánzala desde la terminal

El lanzador gráfico se traga los errores; la terminal no. Abre una terminal y ejecuta:

autofirma

Tres resultados posibles:

• Se abre la ventana. La aplicación funciona; lo que falla es el enlace con el navegador. Salta al apartado del protocolo afirma://.
• Imprime un aviso o una excepción y no hay ventana. Es el caso más común, y el texto te dice cuál de las causas siguientes es la tuya.
• autofirma: command not found. El paquete no está instalado de verdad. Vuelve a la guía de instalación e instálalo con apt o dnf, no con dpkg, para que se resuelvan las dependencias.

«No se puede crear el entorno grafico»: la JRE headless

Si la terminal muestra el aviso «No se puede crear el entorno grafico. Se tratar la peticion como una llamada por consola» —así, con sus erratas—, estás en el caso que la FAQ oficial del proyecto documenta palabra por palabra: tu Java es una JRE headless, la variante sin bibliotecas gráficas que muchas distribuciones instalan por defecto para servidores. Con ella Autofirma puede firmar por consola, pero la ventana no existe.

La solución es instalar una JRE completa y reinstalar Autofirma después:

sudo apt update
sudo apt install openjdk-17-jre
sudo apt install --reinstall ./AutoFirma_Linux.deb

En Fedora, sudo dnf install java-17-openjdk. Fíjate en que el paquete no termine en -headless: openjdk-17-jre-headless es precisamente el que causa el problema.

Un Java demasiado antiguo, o varios a la vez

Autofirma es una aplicación Java y Linux es el único sistema donde usa el Java del equipo: en Windows y macOS el instalador incluye el suyo. El manual de instalación oficial pide un entorno completo de Java 8 o superior y recomienda Java 17; además, los certificados recientes de curva elíptica —algunos de la FNMT y el DNIe 4.0— necesitan un Java moderno, para el que el proyecto recomienda la versión 21 o superior. Con un Java antiguo, Autofirma puede abrirse y aun así mostrar el almacén vacío, que es el terreno del error SAF_19.

Comprueba qué Java responde:

java -version

Si conviven varias versiones —típico tras años de actualizaciones—, elige la predeterminada con:

sudo update-alternatives --config java

y reinstala Autofirma después de cambiarla, porque el paquete se configura contra el Java activo en el momento de la instalación. El detalle de qué necesita Java de verdad y qué errores solo lo parecen está en ¿Autofirma necesita Java?.

El Firefox de snap: Autofirma no encuentra tu perfil

Desde Ubuntu 22.04, Firefox se instala como paquete snap, y eso cambia dónde vive tu perfil: en lugar de ~/.mozilla/firefox, pasa a ~/snap/firefox/common/.mozilla/firefox. Autofirma busca el fichero profiles.ini en la ruta clásica, no lo encuentra, y en el registro del sistema queda la traza exacta: «No se ha encontrado el fichero con los perfiles de Firefox en: /home/…/.mozilla/firefox/profiles.ini». Es la incidencia #282 del proyecto, abierta desde 2022, y afecta también a Linux Mint y a cualquier distribución que empaquete Firefox con snap.

El resultado depende del momento: a veces Autofirma arranca pero no ve ninguno de los certificados que importaste en Firefox, a veces el arranque falla directamente. El arreglo que los propios usuarios documentan en la incidencia es un enlace simbólico que reconstruye la ruta clásica:

cd $HOME
mkdir -p .mozilla
ln -s ../snap/firefox/common/.mozilla/firefox .mozilla/firefox

Después cierra Autofirma del todo y vuelve a abrirla, porque lee el almacén al arrancar. Si usas el Firefox de un paquete .deb clásico o el oficial de Mozilla, esta causa no te afecta.

«No se encuentra ninguna aplicación para abrir enlaces afirma»

Cuando la aplicación abre bien a mano pero no se abre al pulsar «Firmar» en la sede, el eslabón roto es el protocolo afirma://, la dirección especial que el navegador debe asociar al lanzador de Autofirma. Compruébalo:

xdg-mime query default x-scheme-handler/afirma

Debe devolver el lanzador de Autofirma (un fichero .desktop). Si no devuelve nada:

1. Reinstala el paquete con sudo apt install --reinstall ./AutoFirma_Linux.deb.
2. Abre Autofirma una vez desde el menú de aplicaciones, para que termine de registrarse.
3. Repite el trámite en una ventana normal del navegador —el modo incógnito y los perfiles recién creados pierden la asociación— y acepta el diálogo «Abrir Autofirma» cuando aparezca.

Si el navegador lanza la aplicación pero la sede acaba mostrando un error con código SAF_, ya no es un problema de arranque: busca tu código en Todos los errores SAF de Autofirma.

Se abre, pero no ve tus certificados

No es exactamente «no se abre», pero en Linux suele venir en el mismo lote. Autofirma no tiene almacén propio: lee el almacén NSS de Firefox, así que un certificado importado en Chrome o guardado como fichero en tu carpeta personal no existe para ella. Impórtalo en Firefox (Ajustes → Privacidad y seguridad → Ver certificados → Sus certificados → Importar) y reinicia la aplicación. Hay también fallos de Autofirma con las bibliotecas NSS de Ubuntu recientes sin solución confirmada —la incidencia #469, abierta con Ubuntu 24 y Autofirma 1.9, es el hilo a vigilar—; si es tu caso, la salida práctica está dos apartados más abajo.

Cómo resolverlo, en orden

1. autofirma en la terminal y lee lo que imprime.
2. JRE completa: si sale el aviso del entorno gráfico, sudo apt install openjdk-17-jre y reinstala Autofirma.
3. java -version y, si hay varias, sudo update-alternatives --config java.
4. Firefox de snap: crea el enlace simbólico del perfil.
5. xdg-mime query default x-scheme-handler/afirma y, si está vacío, reinstala y abre la aplicación una vez a mano.
6. Certificado en Firefox, no en Chrome, y reinicia Autofirma.
7. Si nada cambia, abre Autofirma y ejecuta Herramientas → Restaurar la instalación, que regenera los certificados de confianza del servicio local.

Firmar sin arreglar nada de esto

Toda esta cadena —Java del sistema, perfil NSS, protocolo registrado en el escritorio— es lo que Autofirma necesita para funcionar como aplicación de escritorio. Si lo que tienes que hacer es entregar un PDF firmado, ninguna de esas piezas hace falta: FirmaLocal calcula la firma PAdES-B-B dentro del navegador, cargando tu certificado directamente desde el fichero .p12, sin Java, sin almacén NSS y sin protocolo que registrar. Ni el documento ni el certificado salen de tu equipo. Firma tu PDF ahora.

Funciona igual en Ubuntu, Mint, Debian, Fedora o Arch, porque solo necesita un navegador; el resto de opciones de escritorio para Linux están comparadas en Firmar PDF con certificado digital en Linux y Ubuntu. El límite honesto: si el trámite exige firmar dentro del formulario de la sede, ahí solo vale Autofirma, y toca arreglarla.

Comprobar que la firma vale

Firmes como firmes, sube el PDF resultante a VALIDe antes de presentarlo. Si reconoce la firma y el titular del certificado, el documento está listo.

Fuentes

• Proyecto clienteafirma, FAQ de ejecución de Autofirma: el aviso literal «No se puede crear el entorno grafico. Se tratar la peticion como una llamada por consola», la JRE headless y la instalación de una JRE completa. Consultada el 2026-09-01.
• Portal de Administración Electrónica, manual de instalación de Autofirma: en Linux se necesita un entorno completo de Java 8 o superior, con Java 17 recomendado. Consultado el 2026-09-01.
• Incidencias de clienteafirma #282 (Firefox de snap en Ubuntu 22.04: «No se ha encontrado el fichero con los perfiles de Firefox», con el enlace simbólico como solución), #263 (el navegador no encuentra aplicación para los enlaces afirma) y #469 (error accediendo a las bibliotecas NSS en Ubuntu 24, abierta). Consultadas el 2026-09-01.
• Proyecto clienteafirma, FAQ de ejecución, certificados de curva elíptica y versiones de Java (recomendación de Java 21 o superior). Consultada el 2026-09-01.