Skip to content

misery/DockerAusweisApp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

70 Commits
 
 
 
 
 
 
 
 

Repository files navigation

AusweisApp in Docker (Linux)

This docker image contains a minimal OS (AlpineLinux) as a base image.

It builds Qt6 and OpenSSL with the cmake library-script of AusweisApp and builds AusweisApp itself.

Also it contains pcscd with some additional card reader driver.

Start

You could start AusweisApp with this command:

docker run --name ausweisapp -p 127.0.0.1:24727:24727 -e DISPLAY=$DISPLAY -e LANG=$LANG -v /tmp/.X11-unix:/tmp/.X11-unix --privileged aklitzing/ausweisapp2
  • --privileged is required for pcscd to access card reader. You could try to bind usb devices to container with -v /dev/bus/usb:/dev/bus/usb instead. Be aware that the usb device must be connected before the container is started! This is a limitation by -v.

If you are not familiar with Docker. You can add -d to docker run to detach from terminal and avoid logging of AusweisApp. After you created a container and stopped it you can start it with docker start ausweisapp if you used the provided name.

Troubleshooting

  • I need a proxy
    • Just add -e http_proxy=PROXY:PORT -e https_proxy=PROXY:PORT to docker run cmdline.
  • I need AusweisApp in English or German.
    • Change -e LANG=$LANG to -e LANG=de or -e LANG=en.
  • Window of AusweisApp is black/faulted.
    • Looks like an OpenGL issue. Try to grab the border of the window and resize it. Sometimes it will refresh the buffers and repaint the window correctly.
  • Container ends immediately
    • Maybe you need to allow local access to your X-Server by xhost local:root.

      No protocol specified
      QXcbConnection: Could not connect to display :0
      Aborted (core dumped)
  • Container ends with Could not load the Qt platform plugin "xcb" in "" even though it was found.
    • Add -e QT_DEBUG_PLUGINS=1 to get more logging of Qt.
  • My card reader is not recognized
    • The container has ccid, pcsc-cyberjack and acsccid drivers installed. Try to install another driver by your own and tell me how you did it. So I can add it to AlpineLinux and to next docker images. See next bullet point.
  • I need to modify the container
    • You can jump into a shell of running container with docker exec -ti ausweisapp /bin/sh and modify it by your needs. You can use sudo as well without a password to get root access.
    • Also you could derive your own Dockerfile from this image by FROM aklitzing/ausweisapp2.
  • Is this an official version?