diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index 2e0123ee51d57a31a7cec0cfc61268db1d0226f9..e774a3e6c496cbbfbc94db6475d32ce09d13916a 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -1,5 +1,10 @@
 # Troubleshooting
 
+## ERROR user: Current not implemented on linux/amd64
+If you encounter this error when running the ksonnet Linux binary, you can temporarily work around it by setting the `USER` environment variable (e.g. `export USER=your-username`).
+
+This error results from cross-compilation (Linux on Mac). To avoid this, future binaries will be built on the appropriate target machines.
+
 ## Github rate limiting errors
 
 If you get an error saying something to the effect of `403 API rate limit of 60 still exceeded` you can work around that by getting a Github personal access token and setting it up so that `ks` can use it.  Github has higher rate limits for authenticated users than unauthenticated users.