commit dd50188f4b0962d6e1f67c8076b1855a01538402 · pyrox.dev/nixpkgs

+32

doc/builders/packages/citrix.section.md

···

       1
       1
       +
       # Citrix Workspace {#sec-citrix}

     

       2
       2
       +
       

     

       3
       3
       +
       The [Citrix Workspace App](https://www.citrix.com/products/workspace-app/) is a remote desktop viewer which provides access to [XenDesktop](https://www.citrix.com/products/xenapp-xendesktop/) installations.

     

       4
       4
       +
       

     

       5
       5
       +
       ## Basic usage {#sec-citrix-base}

     

       6
       6
       +
       

     

       7
       7
       +
       The tarball archive needs to be downloaded manually as the license agreements of the vendor for [Citrix Workspace](https://www.citrix.de/downloads/workspace-app/linux/workspace-app-for-linux-latest.html) needs to be accepted first. Then run `nix-prefetch-url file://$PWD/linuxx64-$version.tar.gz`. With the archive available in the store the package can be built and installed with Nix.

     

       8
       8
       +
       

     

       9
       9
       +
       ## Citrix Selfservice {#sec-citrix-selfservice}

     

       10
       10
       +
       

     

       11
       11
       +
       The [selfservice](https://support.citrix.com/article/CTX200337) is an application managing Citrix desktops and applications. Please note that this feature only works with at least citrix_workspace_20_06_0 and later versions.

     

       12
       12
       +
       

     

       13
       13
       +
       In order to set this up, you first have to [download the `.cr` file from the Netscaler Gateway](https://its.uiowa.edu/support/article/102186). After that you can configure the `selfservice` like this:

     

       14
       14
       +
       

     

       15
       15
       +
       ```ShellSession

     

       16
       16
       +
       $ storebrowse -C ~/Downloads/receiverconfig.cr

     

       17
       17
       +
       $ selfservice

     

       18
       18
       +
       ```

     

       19
       19
       +
       

     

       20
       20
       +
       ## Custom certificates {#sec-citrix-custom-certs}

     

       21
       21
       +
       

     

       22
       22
       +
       The `Citrix Workspace App` in `nixpkgs` trusts several certificates [from the Mozilla database](https://curl.haxx.se/docs/caextract.html) by default. However several companies using Citrix might require their own corporate certificate. On distros with imperative packaging these certs can be stored easily in [`$ICAROOT`](https://developer-docs.citrix.com/projects/receiver-for-linux-command-reference/en/13.7/), however this directory is a store path in `nixpkgs`. In order to work around this issue the package provides a simple mechanism to add custom certificates without rebuilding the entire package using `symlinkJoin`:

     

       23
       23
       +
       

     

       24
       24
       +
       ```nix

     

       25
       25
       +
       with import <nixpkgs> { config.allowUnfree = true; };

     

       26
       26
       +
       let

     

       27
       27
       +
         extraCerts = [

     

       28
       28
       +
           ./custom-cert-1.pem

     

       29
       29
       +
           ./custom-cert-2.pem # ...

     

       30
       30
       +
         ];

     

       31
       31
       +
       in citrix_workspace.override { inherit extraCerts; }

     

       32
       32
       +
       ```

+1 -1

doc/builders/packages/index.xml

···

       5
       5
        
        <para>

     

       6
       6
        
         This chapter contains information about how to use and maintain the Nix expressions for a number of specific packages, such as the Linux kernel or X.org.

     

       7
       7
        
        </para>

     

       8
       8
       -
        <xi:include href="citrix.xml" />

     

       8
       8
       +
        <xi:include href="citrix.section.xml" />

     

       9
       9
        
        <xi:include href="dlib.xml" />

     

       10
       10
        
        <xi:include href="eclipse.section.xml" />

     

       11
       11
        
        <xi:include href="elm.section.xml" />