Skip to content

Flatpak

Bernhard Froehler edited this page Oct 22, 2024 · 24 revisions

For the installation of open_iA under linux we provide a flatpak repository, which is hosted as a github page from the 3dct/flatpak repository. Please see the flatpak page, or the user manual or community of your distribution on how to install flatpak itself; to then install the open_iA flatpak package, enter:

$ sudo flatpak install https://flatpak.3dct.at/openia.flatpakref

$ designates the shell prompt, do not enter this; additionally, on non-Ubuntu systems, you might have to use another way than sudo to gain administrator privileges, please again, refer to the user manual or community of your distribution!

To run open_iA, run:

$ flatpak run at.zfp.openia

Note: The flatpak package does not include:

  • the AI module (no GPU access from flatpak as far as we are aware)
  • the ASTRA modules (it requires CUDA; as far as we know there is no way to address CUDA devices from flatpak yet)
  • the DreamCaster module (requires OpenCL; not supported yet from within flatpak as far as we are aware)
  • the ImNDT/XVRA modules (we didn't have a chance to test yet whether OpenXR/OpenVR hardware can be accessed from within the flatpak sandbox)
  • the HTTP Server parts of the Remote module (used for serving the static part of the remote rendering interface; this will probably soon be available with Qt 6.8 since QtHttpServer moves out of the TechnologyPreview stage with that version)

If you need to run any of these modules on Linux, you will need to build a version for your distribution. Please use our superbuild, which is able to build these modules, or refer to our Build instructions!

Flatpak is our compromise solution, as it is basically impossible to build a generic executable for any linux distribution without it; nor is it feasible with our time budget to build a separate binary release package for all linux distributions currently in use out there.

The binary version in the repository was built using the at.zfp.openia.json manifest in the flatpak repository.

Known Issues

  • Sometimes an error 503 happens when the flatpak installer is pulling the required data from our servers. The simple workaround is to re-run the install command, it will resume downloading where the previous run was aborted!

  • Under some circumstances, the above command might result in the following output:

    error: No such ref 'app/at.zfp.openia/x86_64/stable' in remote openia-origin
    

    A subsequent flatpak remote-ls openia-origin might result in

    error: Unable to load summary from remote openia-origin: Signature made ....
    BAD signature from "Bernhard Froehler <[email protected]>"
    Primary key ID 910BE096048084E2
    

    Workaround: For us it helped to - Execute sudo flatpak update - Execute sudo flatpak install https://flatpak.froehler.org/openia.flatpakref again. See also Flatpak issue #3779, Flatpak issue #4836

  • When running open_iA with drivers that don't support recent versions of OpenGL (e.g., in a virtual machine), you might get an according message. You might be able to work around this by running open_iA via MESA_GL_VERSION_OVERRIDE=3.2 flatpak run at.zfp.openia.

Should you encounter any other issues, please submit an issue!

Clone this wiki locally