NAME

       charliecloud - Lightweight user-defined software stacks for high-performance computing

WHAT IS CHARLIECLOUD?

       Charliecloud  provides  user-defined software stacks (UDSS) for high-performance computing (HPC) centers.
       This “bring your own software stack” functionality addresses needs such as:

       • software  dependencies  that  are  numerous,  complex,  unusual,  differently  configured,  or   simply
         newer/older than what the center provides;

       • build-time requirements unavailable within the center, such as relatively unfettered internet access;

       • validated software stacks and configuration to meet the standards of a particular field of inquiry;

       • portability  of  environments  between resources, including workstations and other test and development
         system not managed by the center;

       • consistent environments, even archivally so, that can be easily, reliabily, and  verifiably  reproduced
         in the future; and/or

       • usability and comprehensibility.

HOW DOES IT WORK?

       Charliecloud  uses  Linux  user namespaces to run containers with no privileged operations or daemons and
       minimal configuration changes on center resources.  This simple approach avoids most security risks while
       maintaining access to the performance and functionality already on offer.

       Container images can be built using Docker or anything else that can generate a standard Linux filesystem
       tree.

HOW DO I LEARN MORE?

       • Documentation: https://hpc.github.io/charliecloud

       • GitHub repository: https://github.com/hpc/charliecloud

       • We wrote an article for USENIX’s magazine ;login: that explains  in  more  detail  the  motivation  for
         Charliecloud       and       the       technology       upon       which       it       is       based:
         https://www.usenix.org/publications/login/fall2017/priedhorsky

       • A more technical resource is our Supercomputing 2017 paper: https://dl.acm.org/citation.cfm?id=3126925

WHO IS RESPONSIBLE?

       The core Charliecloud team at Los Alamos is:

       • Reid Priedhorsky <reidpr@lanl.gov>, co-founder and BDFL

       • Tim Randles <trandles@lanl.gov>, co-founder

       • Michael Jennings <mej@lanl.gov>

       • Jordan Ogas <jogas@lanl.gov>

       Patches (code, documentation, etc.) contributed by:

       • Reid Priedhorsky <reidpr@lanl.gov>

       • Rusty Davis <rustyd@lanl.gov>

       • Oliver Freyermuth <o.freyermuth@googlemail.com>

       • Christoph Junghans <junghans@lanl.gov>

       • Jordan Ogas <jogas@lanl.gov>

       • Matthew Vernon <mv3@sanger.ac.uk>

       • Peter Wienemann <wienemann@physik.uni-bonn.de>

       • Lowell Wofford <lowell@lanl.gov>

HOW CAN I PARTICIPATE?

       Questions, comments, feature requests, bug reports, etc. can be directed to:

       • our mailing list: charliecloud@groups.io or https://groups.io/g/charliecloud

       • issues on GitHub

       Patches are much appreciated on the software itself as well as documentation.  Optionally, please include
       in your first patch a credit for yourself in the list above.

       We are friendly and welcoming of diversity on all dimensions.

COPYRIGHT AND LICENSE

       Charliecloud is copyright © 2014–2018 Los Alamos National Security, LLC. This software has been  approved
       for open source release, LA-CC 14-096.

       Licensed  under  the Apache License, Version 2.0 (the “License”); you may not use this software except in
       compliance with the License. A copy of the license is included in file LICENSE.

       This material was produced under U.S. Government  contract  DE-AC52-06NA25396  for  Los  Alamos  National
       Laboratory  (LANL),  which  is  operated  by Los Alamos National Security, LLC for the U.S. Department of
       Energy. The U.S. Government has rights to use, reproduce,  and  distribute  this  software.  NEITHER  THE
       GOVERNMENT  NOR  LOS ALAMOS NATIONAL SECURITY, LLC MAKES ANY WARRANTY, EXPRESS OR IMPLIED, OR ASSUMES ANY
       LIABILITY FOR THE USE OF THIS SOFTWARE. If  software  is  modified  to  produce  derivative  works,  such
       modified software should be clearly marked, so as not to confuse it with the version available from LANL.

   Reporting bugs
       If  Charliecloud  was  obtained  from  your  Linux  distribution,  use  your distribution’s bug reporting
       procedures.

       Otherwise, report bugs to: <https://github.com/hpc/charliecloud/issues>

SEE ALSO

       ch-build(1), ch-build2dir(1), ch-docker2tar(1),  ch-pull2dir(1),  ch-pull2tar(1),  ch-run(1),  ch-ssh(1),
       ch-tar2dir(1)

       Full documentation at: <https://hpc.github.io/charliecloud>

NOTE

       These man pages are for Charliecloud version 0.9.10 (Git commit ).

AUTHOR

       Reid Priedhorsky, Tim Randles, and others

COPYRIGHT

       2014–2018, Los Alamos National Security, LLC

                                   2019-09-08 18:23 Coordinated Universal Time                   CHARLIECLOUD(1)