actions-marketplace-validations/CernVM File System (cvmfs)

Install the CernVM File System that provides a scalable, reliable and low-maintenance software distribution service.

Trust Signals

Scorecard Score: not yet scored
Maintenance Recency: Activelast commit Feb 16, 2026
License: MIT

Pinned Snippet

workflow.ymlSHA-pinned

uses: actions-marketplace-validations/cvmfs-contrib_github-action-cvmfs@10197e000cc0add8e54ac4fb73d3ed44e2de72b4 # no releases — HEAD as of 2026-07-10

tags can be moved; commit SHAs can't. why a SHA?

Inputs

name	description	required	default
apt_cache	Location (directory) of the user-space apt cache.	no	apt_cache
apt_cache_full	If set to yes, cache APT package lists in addition to .deb packages. This speeds up the action, but may require manual intervention to clear the cache when gh actions runner images are updated	no	no
cvmfs_alien_cache	If set, use an alien cache at the given location.	no	""
cvmfs_alt_root_path	If set to yes, use alternative root catalog path. Only required for fixed catalogs (tag / hash) under the alternative path.	no	""
cvmfs_authz_helper	Full path to an authz helper, overwrites the helper hint in the catalog.	no	""
cvmfs_authz_search_path	Full path to the directory that contains the authz helpers.	no	""
cvmfs_auto_update	If set to no, disables the automatic update of file catalogs.	no	""
cvmfs_backoff_init	Seconds for the maximum initial backoff when retrying to download data.	no	""
cvmfs_backoff_max	Maximum backoff in seconds when retrying to download data.	no	""
cvmfs_cache_base	Location (directory) of the CernVM-FS cache.	no	""
cvmfs_catalog_watermark	Try to release pinned catalogs when their number surpasses the given watermark. Defaults to 1/4 CVMFS_NFILES; explicitly set by shrinkwrap.	no	""
cvmfs_check_permissions	If set to no, disable checking of file ownership and permissions (open all files).	no	""
cvmfs_claim_ownership	If set to yes, allows CernVM-FS to claim ownership of files and directories.	no	""
cvmfs_client_profile	Choose a suitable proxy automatically if set to single.	no	single
cvmfs_config_repo_required	If set to yes, no repository can be mounted unless the config repository is available.	no	""
cvmfs_debuglog	If set, run CernVM-FS in debug mode and write a verbose log the the specified file.	no	""
cvmfs_default_domain	The default domain will be automatically appended to repository names when given without a domain.	no	""
cvmfs_dns_max_ttl	Maximum effective TTL in seconds for DNS queries of proxy server names(not Stratum 1s). Defaults to 1 day.	no	""
cvmfs_dns_min_ttl	Minimum effective TTL in seconds for DNS queries of proxy server names (not Stratum 1s). Defaults to 1 minute.	no	""
cvmfs_dns_retries	Number of retries when resolving proxy names.	no	""
cvmfs_dns_roaming	If true, watch /etc/resolv.conf for nameserver changes.	no	""
cvmfs_dns_timeout	Timeout in seconds when resolving proxy names.	no	""
cvmfs_enforce_acls	Enforce POSIX ACLs stored in the repository. Requires libfuse 3.	no	""
cvmfs_external_fallback_proxy	List of HTTP proxies similar to CVMFS_EXTERNAL_HTTP_PROXY. The fallback proxies are added to the end of the normal proxies, and disable DIRECT connections.	no	""
cvmfs_external_http_proxy	Chain of HTTP proxy groups to be used when CernVM-FS is accessing external data.	no	""
cvmfs_external_timeout	Timeout in seconds for HTTP requests to an external-data server with a proxy server.	no	""
cvmfs_external_timeout_direct	Timeout in seconds for HTTP requests to an external-data server without a proxy server.	no	""
cvmfs_external_url	Semicolon-separated chain of webservers serving external data chunks.	no	""
cvmfs_fallback_proxy	List of HTTP proxies similar to CVMFS_HTTP_PROXY. The fallback proxies are added to the end of the normal proxies, and disable DIRECT connections.	no	""
cvmfs_follow_redirects	When set to yes, follow up to 4 HTTP redirects in requests.	no	""
cvmfs_hide_magic_xattrs	If set to yes the client will not expose CernVM-FS specific extended attributes.	no	""
cvmfs_host_reset_after	See CVMFS_PROXY_RESET_AFTER.	no	""
cvmfs_http_proxy	Chain of HTTP proxy groups used by CernVM-FS. Defaults to DIRECT.	no	DIRECT
cvmfs_ignore_signature	When set to yes, don’t verify CernVM-FS file catalog signatures.	no	""
cvmfs_initial_generation	Initial inode generation. Used for testing.	no	""
cvmfs_instrument_fuse	When set to true gather performance statistics about the FUSE callbacks. The results are displayed with cvmfs_talk internal affairs.	no	""
cvmfs_ipfamily_prefer	Which IP protocol to prefer when connecting to proxies. Can be either 4 or 6.	no	""
cvmfs_kcache_timeout	Timeout for path names and file attributes in the kernel file system buffers.	no	""
cvmfs_keys_dir	Directory containing *.pub files used as repository signing keys. If set, this parameter has precedence over CVMFS_PUBLIC_KEY.	no	""
cvmfs_low_speed_limit	Minimum transfer rate a server or proxy must provide.	no	""
cvmfs_max_external_servers	Limit the number of (geo sorted) stratum 1 servers for external data that are effectively used.	no	""
cvmfs_max_ipaddr_per_proxy	Limit the number of IP addresses a proxy names resolves into. From all registered addresses, up to the limit are randomly selected.	no	""
cvmfs_max_retries	Maximum number of retries for a given proxy/host combination.	no	""
cvmfs_max_servers	Limit the number of (geo sorted) stratum 1 servers that are effectively used.	no	""
cvmfs_max_ttl	Maximum file catalog TTL in minutes. Can overwrite the TTL stored in the catalog.	no	""
cvmfs_memcache_size	Size of the CernVM-FS meta-data memory cache in Megabytes.	no	""
cvmfs_mount_rw	Mount CernVM-FS as a read/write file system. Write operations will fail but this option can workaround faulty open() flags.	no	""
cvmfs_nfiles	Maximum number of open file descriptors that can be used by the CernVM-FS process.	no	""
cvmfs_nfs_interleaved_inodes	In NFS mode, use only inodes of the form an+b, specified as “b%a”.	no	""
cvmfs_nfs_shared	If set to a path, used to store the NFS maps in an SQlite database, instead of the usual LevelDB storage in the cache directory.	no	""
cvmfs_nfs_source	If set to yes, act as a source for the NFS daemon (NFS export).	no	""
cvmfs_oom_score_adj	Set the Linux kernel’s out-of-memory killer priority for the CernVM-FS client [-1000 - 1000].	no	""
cvmfs_pac_urls	Chain of URLs pointing to PAC files with HTTP proxy configuration information.	no	""
cvmfs_proxy_reset_after	Delay in seconds after which CernVM-FS will retry the primary proxy group in case of a fail-over to another group.	no	""
cvmfs_proxy_template	Overwrite the default proxy template in Geo-API calls. Only needed for debugging.	no	""
cvmfs_public_key	Colon-separated list of repository signing keys.	no	""
cvmfs_quota_limit	Soft-limit of the cache in Megabyte. Consult https://docs.github.com/en/free-pro-team@latest/actions/reference/specifications-for-github-hosted-runners#supported-runners-and-hardware-resources before changing	no	15000
cvmfs_reload_sockets	Directory of the sockets used by the CernVM-FS loader to trigger hotpatching/reloading.	no	""
cvmfs_repositories	Comma-separated list of fully qualified repository names that shall be mountable under /cvmfs.	no	""
cvmfs_repository_date	A timestamp in ISO format (e.g. 2007-03-01T13:00:00Z). Selects the repository state as of the given date.	no	""
cvmfs_repository_tag	Select a named repository snapshot that should be mounted instead of trunk.	no	""
cvmfs_root_hash	Hash of the root file catalog, implies CVMFS_AUTO_UPDATE=no.	no	""
cvmfs_send_info_header	If set to yes, include the cvmfs path of downloaded data in HTTP headers.	no	""
cvmfs_server_cache_mode	Enable special cache semantics for a client used as a publisher’s repository base line.	no	""
cvmfs_server_url	Semicolon-separated chain of Stratum~1 servers.	no	""
cvmfs_shared_cache	If set to no, makes a repository use an exclusive cache.	no	""
cvmfs_strict_mount	If set to yes, mount only repositories that are listed in CVMFS_REPOSITORIES.	no	""
cvmfs_suid	If set to yes, enable suid magic on the mounted repository. Requires mounting as root.	no	""
cvmfs_syslog_facility	If set to a number between 0 and 7, uses the corresponding LOCAL$n$ facility for syslog messages.	no	""
cvmfs_syslog_level	If set to 1 or 2, sets the syslog level for CernVM-FS messages to LOG_DEBUG or LOG_INFO respectively.	no	""
cvmfs_systemd_nokill	If set to yes, modify the command line to @vmfs2 ... in order to act as a systemd lowlevel storage manager.	no	""
cvmfs_timeout	Timeout in seconds for HTTP requests with a proxy server.	no	""
cvmfs_timeout_direct	Timeout in seconds for HTTP requests without a proxy server.	no	""
cvmfs_tracefile	If set, enables the tracer and trace file system calls to the given file.	no	""
cvmfs_use_cdn	Change the stratum 1 endpoints to caching servers from Cloudflare.	no	yes
cvmfs_use_geoapi	Request order of Stratum 1 servers and fallback proxies via Geo-API.	no	""
cvmfs_user	Sets the gid and uid mount options. Don’t touch or overwrite.	no	""
cvmfs_usyslog	All messages that normally are logged to syslog are re-directed to the given file. This file can grow up to 500kB and there is one step of log rotation. Required for $mu$CernVM.	no	""
cvmfs_workspace	Set the local directory for storing special files (defaults to the cache directory).	no	""
cvmfs_ubuntu_deb_location	Location from where to download the Ubuntu deb package of CernVM-FS	no	https://cvmrepo.s3.cern.ch/cvmrepo/apt/cvmfs-release-latest_all.deb
cvmfs_config_package	URL to the cvmfs config package to install	no	cvmfs-config-default
run_local_checkout	Run the local checkout of the action and not the main repo code	no	false

Outputs

no outputs