Skip to main content

Custom Folder

The Custom folder in the context of the openthinclient server offers a flexible way to distribute individual files and configurations to the thin clients. Common uses include storing certificates and customizing icons and desktop backgrounds.

Experienced users can use the Custom folder to distribute configurations or scripts. Overwrite files as needed.

Path

openthinclient Installer: <Manager-Home>/nfs/root/custom/

The Manager home directory was specified during the installation of openthinclient.

openthinclient Virtual Appliance: /home/openthinclient/otc-manager-home/nfs/root/custom/

ThinClient (PXE booted): /tcos/link

Structure

 <Manager-Home>/nfs/root/custom/
browser-ssl-certs/ Import server certificates into the browser.
ica-ssl-certs/ CA certificates for Citrix

system-certs/

System-wide server certificates; these are used by FreeRDP, VMware, and others.
icons/

Use application icons in PNG or SVG format.

Use PNG icons at 16 × 16 or 32 × 32 px.

Usage:

Specify the file name, including the extension, as a custom icon in the application configuration.
splashscreens/

Boot splash screens in PPM format.

Usage:

Specify the file name (including the extension) in the hardware type.

The filename tcos-splash.ppm Reserve the filename for system use.
rootfs/

Copy any files and directories to the thin clients. Overwrite existing files.
packages/

Include any files and directories in tar archive files.

Distribute any files

Using rootfs/ and packages/ , distribute any files and directories to the thin clients. Under rootfs/ or within a tar archive file in packages/ Specify the full path within the tar archive. During the boot process, copy the files to the thin clients before Debian starts.

rootfs/

Files distributed via this folder have the following properties on the thin clients:

  • Owner: the logged-in user User-ID 1000
  • Executable and Readable für alle
  • Writable for owner
packages/

Preserve file permissions and ownership.

Exception: Files in the user directory /home/tcosalways belong to the logged-in user User-ID 1000.

Supported archive formats
Uncompressed tar

.tar
bzip2-compressed tar

.tar.bz2

 .tar.bz
gzip-compressed tar

.tar.gz

 .tgz

Process only these archive formats.

Examples

Place the file on the ThinClient desktop:

  1. In rootfs/ Create the entire directory tree,
    <Manager-Home>/nfs/root/custom/rootfs/home/tcos/Desktop
  2. Create a file in this directory.
  3. After the thin clients boot up, the file'll be visible on the desktop.

Store SSL certificates from the certification authority (Citrix):

During the thin client boot process, copy certificates from certification authorities to the thin client. The system automatically converts all certificates to the required format. Store the certificates from the certification authorities on the server in the following folder <Manager-Home>/nfs/root/custom/ica-ssl-certs/.

Custom background image:

Save the desired background image on the server with the following filename:<Manager-Home>/nfs/root/custom/rootfs/usr/share/wallpapers/openthinclient/default.png 

If the path below .../rootfs/ If the path doesn't exist, create it exactly as described here.

Back to top