Download, Installation and Activation#

cunoFS supports the Linux operating system, and can run inside Docker and other virtual environments such as Hyper-V and Virtualbox.

cunoFS offers a “Scripted Installer” which does not require root privileges to install. We also offer distributions that can be installed using popular Linux package managers. All of our releases are available on GitHub.

Note

A licence is required to use cunoFS, get a free licence by signing up at cuno.io/register.

A free licence lets you use all features for 14 days, and thereafter you will be limited to the Personal tier of usage.

Downloading and installing#

The Scripted Installer allows you to install cunoFS without root privileges (no sudo).

Note

For full details about user privileges for installation, see the user guide.

  1. Download the installer. By downloading you are agreeing to the terms of the End User License Agreement. Click to download the latest version from your browser, or run the command:

    wget https://github.com/cunoFS/cunoFS/releases/latest/download/cuno-glibc-installer.run
    
  2. To install only for the current user, run the following terminal command:

    sh cuno-glibc-installer.run
    

    To install system-wide, run:

    sudo sh cuno-glibc-installer.run
    
  3. Please follow the interactive steps, read the displayed end-user licence agreement (EULA) and agree to the terms to continue with the installation.

  4. The installation will prompt you to set the CUNO_ROOT environment variable to the installation directory. This is not always necessary when using cunoFS, but it will make it easier to follow the steps in this guide.

Activating your licence#

Activate your licence by running the command and following the interactive steps:

cuno creds activate

Testing your installation#

You should now be able to run cunoFS from the command line, which you can test out by running the following command:

cuno version

To test that cunoFS is fully working before connecting your own object storage, you can use it to browse publicly available data. In the following example, we use cunoFS to browse space telescope data hosted on the stpubdata Amazon S3 bucket:

$ cuno run sh -c "ls s3://stpubdata/"

galex  hst  jwst  k2  kepler  panstarrs  tess

$ cuno run sh -c "ls s3://stpubdata/tess/public/*"

's3://stpubdata/tess/public/ffi':
s0001  s0005  s0009  s0013  s0017  s0021  s0025  s0029 ... [truncated]

's3://stpubdata/tess/public/mast':
tess-s0001-1-1-cube.fits  tess-s0012-1-4-cube.fits  tess-s0023-2-3-cube.fits ... [truncated]

... [truncated]

Note

Note that cuno run is a way to run a single command within a cunoFS context. Most of the time, and for interactive usage, we recommend starting a “wrapped” shell using the command cuno - see the Loading cunoFS section of this guide for more information, or the equivalent section from the full user guide for extra detail.