aboutsummaryrefslogtreecommitdiff
path: root/README.org
diff options
context:
space:
mode:
authorArun Isaac2021-11-29 21:03:08 +0530
committerArun Isaac2021-11-29 21:06:26 +0530
commit253cd011d4d00351da0ae30f39b44d340bbcc36e (patch)
tree75eaffe3785ca9c6be1ef161fac3e30fbbd40194 /README.org
parent5bdb24c18b5d6abed13ad004325b1bf66eaeca74 (diff)
downloadccwl-253cd011d4d00351da0ae30f39b44d340bbcc36e.tar.gz
ccwl-253cd011d4d00351da0ae30f39b44d340bbcc36e.tar.lz
ccwl-253cd011d4d00351da0ae30f39b44d340bbcc36e.zip
README: Add instructions for installation using software bundles.
* README.org (Installation)[Using binary software bundles]: New subsection.
Diffstat (limited to 'README.org')
-rw-r--r--README.org31
1 files changed, 31 insertions, 0 deletions
diff --git a/README.org b/README.org
index a9504a8..695a265 100644
--- a/README.org
+++ b/README.org
@@ -15,6 +15,37 @@ can interactively execute workflows while developing them.
#+END:
* Installation
+** Using binary software bundles
+
+If you don't have [[https://guix.gnu.org/][GNU Guix]] set up, the easiest way to quickly try ccwl
+is to using the provided software bundles---either using the Guix
+tarball pack or the Docker image.
+
+*** Using the Guix tarball pack
+
+Download the Guix tarball pack from [[https://github.com/arunisaac/ccwl/releases][the GitHub releases page]] and
+extract it. Then, run ccwl with command-line arguments of your choice.
+#+BEGIN_SRC shell
+ $ tar -xf ccwl-pack.tar.gz
+ $ ./opt/gnu/bin/ccwl [ARGS...]
+#+END_SRC
+
+*** Using the Docker image
+
+Download the Docker image from [[https://github.com/arunisaac/ccwl/releases][the GitHub releases page]] and load
+it. Then, run ccwl with command-line arguments of your choice.
+#+BEGIN_SRC shell
+ $ docker load -i ccwl-docker.tar.gz
+ $ docker run ccwl [ARGS...]
+#+END_SRC
+
+When passing files into the Docker container, remember to share the
+filesystem. The following command is one way to share the current
+directory with the container.
+#+BEGIN_SRC shell
+ $ docker run -v "$PWD:$PWD" -w "$PWD" ccwl compile foo.scm
+#+END_SRC
+
** Using Guix
The easiest and best way (considering reproducibility) is to install