coder · mafredri · Jul 21, 2023 · Jul 19, 2023 · Jul 19, 2023 · Jul 19, 2023
diff --git a/cli/dotfiles.go b/cli/dotfiles.go
@@ -193,6 +193,18 @@ func (r *RootCmd) dotfiles() *clibase.Cmd {
 				}
 
 				_, _ = fmt.Fprintf(inv.Stdout, "Running %s...\n", script)
+
+				// Check if the script is executable and notify on error
+				scriptPath := filepath.Join(dotfilesDir, script)
+				fi, err := os.Stat(scriptPath)
+				if err != nil {
+					return xerrors.Errorf("stat %s: %w", scriptPath, err)
+				}
+
+				if fi.Mode()&0o111 == 0 {
+					return xerrors.Errorf("%[1]q script is not executable. Please check https://coder.com/docs/v2/latest/dotfiles, s
10000
cript)
+				}
+
 				// it is safe to use a variable command here because it's from
 				// a filtered list of pre-approved install scripts
 				// nolint:gosec

diff --git a/docs/dotfiles.md b/docs/dotfiles.md
@@ -60,3 +60,30 @@ sudo apt update
 # Install some of my favorite tools every time my workspace boots
 sudo apt install -y neovim fish cargo
 ```
+
+## Install or Setup script support
+
+User can have either of the following setup script files in their dotfiles repo:
+
+- install.sh
+- install
+- bootstrap.sh
+- bootstrap
+- script/bootstrap
+- setup.sh
+- setup
+- script/setup
+
+If any of the above files are found in the specified order, Coder will execute the first match, and the rest will be skipped.
+
+The Setup scripts must be executable. If they are not, Coder will not execute them. If the script is not executable, you can make it executable by running:
+
+```bash
+cd <path_to_dotfiles_repo>
+
+chmod +x <script_name>
+
+git commit -m "Make <script_name> executable" <script_name>
+
+git push
+```