summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGravatar Joey Hess <joeyh@joeyh.name>2015-08-09 17:18:04 -0400
committerGravatar Joey Hess <joeyh@joeyh.name>2015-08-09 17:25:13 -0400
commit315b05f2b717179dfcc8fece788dc6ad2f629796 (patch)
treebbd292e518ef183aba4fb4a174221ffc76d78830
parentc3f6b13014ae025a0837fb6f7a171aeae5dd2761 (diff)
document a PATH issue
-rw-r--r--doc/forum/Remote__39__s_git-annex-shell_not_detected/comment_2_35e5d9b427963fc7b9618eb522bd1273._comment10
-rw-r--r--doc/install/NixOS.mdwn19
2 files changed, 29 insertions, 0 deletions
diff --git a/doc/forum/Remote__39__s_git-annex-shell_not_detected/comment_2_35e5d9b427963fc7b9618eb522bd1273._comment b/doc/forum/Remote__39__s_git-annex-shell_not_detected/comment_2_35e5d9b427963fc7b9618eb522bd1273._comment
new file mode 100644
index 000000000..6e37bdb4e
--- /dev/null
+++ b/doc/forum/Remote__39__s_git-annex-shell_not_detected/comment_2_35e5d9b427963fc7b9618eb522bd1273._comment
@@ -0,0 +1,10 @@
+[[!comment format=mdwn
+ username="joey"
+ subject="""comment 2"""
+ date="2015-08-09T21:20:05Z"
+ content="""
+Another way to deal with the problem is to find the location where
+git-annex-shell is installed on the remote system's Nix store, and
+configure the git remote for that system to use that location, by setting
+`remote.<name>.annex-shell` in its git configuration.
+"""]]
diff --git a/doc/install/NixOS.mdwn b/doc/install/NixOS.mdwn
index e9730b285..23d7a9931 100644
--- a/doc/install/NixOS.mdwn
+++ b/doc/install/NixOS.mdwn
@@ -8,3 +8,22 @@ When including it in a NixOS configuration.nix file, the name of the reference t
The build status of the package within Nix can be seen on the [Hydra Build
Farm](http://hydra.nixos.org/job/nixpkgs/trunk/gitAndTools.gitAnnex).
+
+----
+
+If git-annex is installed using Nix on a non-NixOS system, note that
+git-annex-shell will not be available in PATH if git-annex tries to ssh
+into the system and run it. This is because bash is typically built
+without the flag `-DSSH_SOURCE_BASHRC`, and so the .bashrc that sets up the
+PATH to include Nix-installed packages is not read.
+
+This is not a problem when using NixOS, because it does build bash with
+that flag. Nor is this a problem when using git-annex locally.
+But, if you're setting up a server that will be used as a git
+remote, you'll need to find a way to get git-annex-shell
+into the PATH, or otherwise deal with this.
+
+Another way to deal with the problem is to find the location where
+git-annex-shell is installed on the remote system, and configure the git
+remote for that system to use that location, by setting
+`remote.<name>.annex-shell` in its git configuration.