D 2020-05-12T18:19:31.312
L AppFS
N text/x-markdown
P 6c4fdd187d3547472299314653aaac44582eb688
U rkeene
W 4474
Files on disk.
==============

AppFS is a universal packaging format that is presented to the system as a filesystem (via FUSE).  Packages manifests as well as individual package files are lazily-fetched (Just-In-Time) and cached to disk so the "installation" step is transparent.  Regular unprivileged users can read (and write!) to any file in any package, thus allowing completely unprivileged "installation" of packages and allowing users to update configuration files for the package.

All remote files in AppFS are identified by the SHA1 of their contents so multiple users accessing the same file (content-wise) will share the same locally cached copy.

It is similar to the the original 0install implementation, [LazyFS](http://sourceforge.net/projects/zero-install/files/OLD-lazyfs-linux/).  It supports many features required for large scale deployments.  It has the following fancy features:

   * Write support: Writes are redirected to the users HOME directory
   * Set-UID root support: Administrators may set conditions on which files are Set-UID root (by default, no files are)
   * Run-time configuration reloading: All configuration may be reloaded at run-time
   * PKI support: Package providers can optionally sign index files, which in turn signs all packages and all files in packages (unsigned indexes are untrusted by default)

It should be mounted in `/opt/appfs`.  Once mounted, sub-directories will be automatically made available by attempting to access the hostname of an AppFS server.  For example, `/opt/appfs/core.appfs.rkeene.org` contains:

`$ ls -l /opt/appfs/core.appfs.rkeene.org/`<br>
`total 0`<br>
  `dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`acl`</font>`/`<br>
`dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`appfs`</font>`/`<br>
`dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`applications`</font>`/`<br>
`dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`attr`</font>`/`<br>
`dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`bash`</font>`/`<br>
`dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`binutils`</font>`/`<br>
`dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`bzip2`</font>`/`<br>
`dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`coreutils`</font>`/`<br>
`dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`glibc`</font>`/`<br>
`dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`gmp`</font>`/`<br>
`dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`libcap`</font>`/`<br>
`dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`linux-headers`</font>`/`<br>
`dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`mpc`</font>`/`<br>
`dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`mpfr`</font>`/`<br>
`dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`ncurses`</font>`/`<br>
`dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`readline`</font>`/`<br>
`dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`tcl`</font>`/`<br>
`dr-xr-xr-x 4 root root 0 Nov 19 04:02 `&nbsp;<font color="blue">`zlib`</font>`/`<br>
`$ `

Demo
----

<script type="text/javascript" src="https://asciinema.org/a/20465.js" id="asciicast-20465" async></script>

Browser
-------

  * [Online Browser](https://browser.appfs.net/)

Download
--------
  *  [Version 1.14](/uv/releases/1.14/appfs-1.14.tar.gz) (<small>[Browse Code](dir?ci=1.14&type=tree)</small>) (**LATEST**)
  *  [Version 1.12](/uv/releases/1.12/appfs-1.12.tar.gz) (<small>[Browse Code](dir?ci=1.12&type=tree)</small>)
  *  [Version 1.10](/uv/releases/1.10/appfs-1.10.tar.gz) (<small>[Browse Code](dir?ci=1.10&type=tree)</small>)
  *  [Version 1.8](/uv/releases/1.8/appfs-1.8.tar.gz) (<small>[Browse Code](dir?ci=1.8&type=tree)</small>)
  *  [Version 1.6](/uv/releases/1.6/appfs-1.6.tar.gz) (<small>[Browse Code](dir?ci=1.6&type=tree)</small>)
  *  [Version 1.4](/uv/releases/1.4/appfs-1.4.tar.gz) (<small>[Browse Code](dir?ci=1.4&type=tree)</small>)
  *  [Version 1.2](/uv/releases/1.2/appfs-1.2.tar.gz) (<small>[Browse Code](dir?ci=1.2&type=tree)</small>)
  *  [Version 1.0](/uv/releases/1.0/appfs-1.0.tar.gz) (<small>[Browse Code](dir?ci=1.0&type=tree)</small>)

Documentation
-------------
  *  [Getting Started](home/Getting Started)
  *  [Manual](home/Manual)
Z 87ac1211467d0f671fd3ba403175b393