aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md18
1 files changed, 14 insertions, 4 deletions
diff --git a/README.md b/README.md
index 6e33e8c..f328e87 100644
--- a/README.md
+++ b/README.md
@@ -21,8 +21,6 @@ A continuously deployed instance of genenetwork3 is available at
redeployed on every commit provided that the [continuous integration
tests](https://ci.genenetwork.org/jobs/genenetwork3) pass.
-
-
## Installation
#### GNU Guix packages
@@ -35,6 +33,8 @@ There are at least three ways to start GeneNetwork3 with GNU Guix:
2. Create a container with `guix shell -C`
3. Use a profile and shell settings with `source ~/opt/genenetwork3/etc/profile`
+At this point we use all three for different purposes.
+
#### Create an environment:
Simply load up the environment (for development purposes):
@@ -43,7 +43,7 @@ Simply load up the environment (for development purposes):
guix shell -Df guix.scm
```
-Also, make sure you have the [guix-bioinformatics](https://git.genenetwork.org/guix-bioinformatics/guix-bioinformatics) channel set up.
+Also, make sure you have the guix-bioinformatics channel set up correctly and this should work
```bash
guix shell --expose=$HOME/genotype_files/ -Df guix.scm
@@ -51,7 +51,15 @@ python3
import redis
```
-#### Run a Guix container
+Check if guix and guix-bioinformatics channel are up-to-date with
+
+```
+guix describe
+```
+
+#### Run a Guix container with network
+
+Containers provide full isolation from the underlying distribution. Very useful for figuring out any dependency issues:
```
guix shell -C --network --expose=$HOME/genotype_files/ -Df guix.scm
@@ -59,6 +67,8 @@ guix shell -C --network --expose=$HOME/genotype_files/ -Df guix.scm
#### Using a Guix profile (or rolling back)
+A guix profile is different from a Guix shell - it has less isolation from the underlying distribution.
+
Create a new profile with
```