787

I'm writing a Bash script. I need the current working directory to always be the directory that the script is located in.

The default behavior is that the current working directory in the script is that of the shell from which I run it, but I do not want this behavior.

5
  • Have you considered putting a wrapper script somewhere like /usr/bin to cd into the (hardcoded) proper directory and then execute your script? Jul 28, 2010 at 1:02
  • 2
    Why do you need the directory of the script? There's probably a better way to solve the underlying problem.
    – bstpierre
    Jul 28, 2010 at 3:59
  • 18
    I'd just like to point out that the behavior you call "obviously undesirable" is in fact entirely necessary -- if I run myscript path/to/file I expect the script to evaluate path/to/file relative to MY current directory, not whatever directory the script happens to be located in. Also, what would you have happen for a script run with ssh remotehost bash < ./myscript as the BASH FAQ mentions? Jul 28, 2010 at 4:54
  • possible duplicate of Can a Bash script tell what directory it's stored in?
    – kenorb
    Apr 24, 2015 at 2:23
  • 4
    cd "${BASH_SOURCE%/*}" || exit
    – caw
    Jul 7, 2017 at 23:48

13 Answers 13

937
#!/bin/bash
cd "$(dirname "$0")"
19
  • 9
    dirname returns '.' when using bash under Windows. So, Paul's answer is better.
    – Tvaroh
    May 28, 2013 at 10:10
  • 9
    Also returns '.' in Mac OSX Jul 11, 2013 at 18:16
  • 4
    It's worth noting that things can break if a symbolic link makes up part of $0. In your script you may expect, for example, ../../ to refer to the directory two levels above the script's location, but this isn't necessarily the case if symbolic links are in play.
    – Rag
    Dec 24, 2013 at 8:51
  • 36
    If you called the script as ./script, . is the correct directory, and changing to . it will also end up in the very directory where script is located, i.e. in the current working directory.
    – ndim
    Aug 27, 2014 at 20:10
  • 12
    If you run the script from the current directory like so bash script.sh, then the value of $0 is script.sh. The only way the cd command will "work" for you is because you don't care about failed commands. If you were to use set -o errexit (aka: set -e) to ensure that your script doesn't blow past failed commands, this would NOT work because cd script.sh is an error. The reliable [bash specific] way is cd "$(dirname ${BASH_SOURCE[0]})" Dec 18, 2016 at 18:55
392

The following also works:

cd "${0%/*}"

The syntax is thoroughly described in this StackOverflow answer.

12
  • 21
    Explanation how it works: stackoverflow.com/questions/6393551/…
    – kenorb
    Jul 19, 2013 at 10:34
  • 29
    Don't forget to enclose in quotes if the path contains whitespace. i.e. cd "${0%/*}"
    – H.Rabiee
    Aug 1, 2013 at 10:43
  • 23
    This fails if the script is called with bash script.sh -- $0 will just be the name of the file May 8, 2015 at 15:06
  • 2
    neither it works if a script is in the root directory, because "${0%/*}" would expand to empty string
    – jmster
    May 21, 2015 at 8:29
  • 21
    I would say this answer is too succinct. You hardly learn anything about the syntax. Some description about how to read this would be helpful.
    – fraxture
    Feb 18, 2016 at 9:44
252

Try the following simple one-liners:


For all UNIX/OSX/Linux

dir="$(cd -P -- "$(dirname -- "$0")" && pwd -P)"

Bash

dir="$(cd -P -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd -P)"

Note: A double dash (--) is used in commands to signify the end of command options, so files containing dashes or other special characters won't break the command.

Note: In Bash, use ${BASH_SOURCE[0]} in favor of $0, otherwise the path can break when sourcing it (source/.).


*For Linux, Mac and other BSD:

cd "$(dirname "$(realpath -- "$0")")";

Note: realpath should be installed in the most popular Linux distribution by default (like Ubuntu), but in some it can be missing, so you have to install it.

Note: If you're using Bash, use ${BASH_SOURCE[0]} in favor of $0, otherwise the path can break when sourcing it (source/.).

Otherwise you could try something like that (it will use the first existing tool):

cd "$(dirname "$(readlink -f -- "$0" || realpath -- "$0")")"

For Linux specific:

cd "$(dirname "$(readlink -f -- "$0")")"

*Using GNU readlink on BSD/Mac:

cd "$(dirname "$(greadlink -f -- "$0")")"

Note: You need to have coreutils installed (e.g. 1. Install Homebrew, 2. brew install coreutils).


In bash

In bash you can use Parameter Expansions to achieve that, like:

cd "${0%/*}"

but it doesn't work if the script is run from the same directory.

Alternatively you can define the following function in bash:

realpath () {
  [[ "$1" = /* ]] && echo "$1" || echo "$PWD/${1#./}"
}

This function takes 1 argument. If argument has already absolute path, print it as it is, otherwise print $PWD variable + filename argument (without ./ prefix).

or here is the version taken from Debian .bashrc file:

function realpath()
{
    f=$@
    if [ -d "$f" ]; then
        base=""
        dir="$f"
    else
        base="/$(basename -- "$f")"
        dir="$(dirname -- "$f")"
    fi
    dir="$(cd -- "$dir" && /bin/pwd)"
    echo "$dir$base"
}

Related:

See also:

How can I get the behavior of GNU's readlink -f on a Mac?

12
  • 7
    a much better answer than the popular ones because it resolves syslinks, and accounts for different OS's. Thanks!
    – Dennis
    Oct 3, 2013 at 17:08
  • 3
    A double dash (--) is used in commands to signify the end of command options, so files containing dashes or other special characters won't break the command. Try e.g. create the file via touch "-test" and touch -- -test, then remove the file via rm "-test" and rm -- -test, and see the difference.
    – kenorb
    Jun 12, 2014 at 8:15
  • 1
    I'd remove my upvote if I could: realpath is deprecated unix.stackexchange.com/questions/136494/…
    – lsh
    Nov 5, 2015 at 13:03
  • 2
    @lsh It says that only Debian realpath package is deprecated, not GNU realpath. If you think it's not clear, you can suggest an edit.
    – kenorb
    Nov 5, 2015 at 13:55
  • 2
    Shouldn't all the examples like cd "$(dirname "$(realpath "$0")")" also use -- before the parameter, like cd "$(dirname -- "$(realpath -- "$0")")"?
    – ntninja
    Jan 17, 2021 at 9:03
96
cd "$(dirname "${BASH_SOURCE[0]}")"

It's easy. It works.

5
  • 1
    This should be the accepted answer. Works on OSX and Linux Ubuntu. Jan 5, 2016 at 19:19
  • 6
    This works great when the script B is sourced from other script A and you need to use paths relative to script B. Thank you.
    – Enrico
    Mar 19, 2016 at 18:48
  • 7
    This also works in Cygwin for those of us unfortunate enough to have to touch Windows. Dec 18, 2016 at 18:33
  • 4
    Or cd "${BASH_SOURCE%/*}" || exit
    – caw
    Jul 7, 2017 at 23:49
  • 2
    Works on macOS Mojave
    – Juan Boero
    Jul 30, 2019 at 19:22
20

The accepted answer works well for scripts that have not been symlinked elsewhere, such as into $PATH.

#!/bin/bash
cd "$(dirname "$0")"

However if the script is run via a symlink,

ln -sv ~/project/script.sh ~/bin/; 
~/bin/script.sh

This will cd into the ~/bin/ directory and not the ~/project/ directory, which will probably break your script if the purpose of the cd is to include dependencies relative to ~/project/

The symlink safe answer is below:

#!/bin/bash
cd "$(dirname "$(readlink -f "${BASH_SOURCE[0]}")")"  # cd current directory

readlink -f is required to resolve the absolute path of the potentially symlinked file.

The quotes are required to support filepaths that could potentially contain whitespace (bad practice, but its not safe to assume this won't be the case)

15

There are a lot of correct answers in here, but one that tends to be more useful for me (making sure a script's relative paths remain predictable/work) is to use pushd/popd:

pushd "$(dirname ${BASH_SOURCE:0})"
trap popd EXIT

# ./xyz, etc...

This will push the source file's directory on to a navigation stack, thereby changing the working directory, but then, when the script exits (for whatever reason, including failure), the trap will run popd, restoring the current working directory before it was executed. If the script were to cd and then fail, your terminal could be left in an unpredictable state after the execution ends - the trap prevents this.

10

This script seems to work for me:

#!/bin/bash
mypath=`realpath $0`
cd `dirname $mypath`
pwd

The pwd command line echoes the location of the script as the current working directory no matter where I run it from.

3
  • 3
    realpath is unlikely to be installed everywhere. Which may not matter, depending on the OP's situation.
    – bstpierre
    Jul 28, 2010 at 3:42
  • My system doesn't have realpath but it does have readlink which seems to be similar. Jul 28, 2010 at 3:46
  • 2
    Which dist doesn't have realpath installed by default? Ubuntu has it.
    – kenorb
    Jul 19, 2013 at 11:15
3

I take this and it works.

#!/bin/bash
cd "$(dirname "$0")"
CUR_DIR=$(pwd)
0
2

Get the real path to your script

if [ -L $0 ] ; then
    ME=$(readlink $0)
else
    ME=$0
fi
DIR=$(dirname $ME)

(This is answer to the same my question here: Get the name of the directory where a script is executed)

1
cd "`dirname $(readlink -f ${0})`"
3
  • 1
    Can you explain your answer please ?
    – Zulu
    Oct 27, 2015 at 12:31
  • 2
    Although this code may help to solve the problem, it doesn't explain why and/or how it answers the question. Providing this additional context would significantly improve its long-term educational value. Please edit your answer to add explanation, including what limitations and assumptions apply. Oct 24, 2016 at 16:16
  • ${0} would give the file name of the script. readlink -f {0} would give that script's absolute path. dirname would extract the script located path from previous result. Jul 21, 2022 at 6:17
1

Most answers either don't handle files which are symlinked via a relative path, aren't one-liners or don't handle BSD (Mac). A solution which does all three is:

HERE=$(cd "$(dirname "$BASH_SOURCE")"; cd -P "$(dirname "$(readlink "$BASH_SOURCE" || echo .)")"; pwd)

First, cd to bash's conception of the script's directory. Then readlink the file to see if it is a symlink (relative or otherwise), and if so, cd to that directory. If not, cd to the current directory (necessary to keep things a one-liner). Then echo the current directory via pwd.

You could add -- to the arguments of cd and readlink to avoid issues of directories named like options, but I don't bother for most purposes.

You can see the full explanation with illustrations here:

https://www.binaryphile.com/bash/2020/01/12/determining-the-location-of-your-script-in-bash.html

-9
echo $PWD

PWD is an environment variable.

1
  • 5
    This only gives the directory called from, not the directory where the script is.
    – dagelf
    Aug 9, 2017 at 8:00
-10

If you just need to print present working directory then you can follow this.

$ vim test

#!/bin/bash
pwd
:wq to save the test file.

Give execute permission:

chmod u+x test

Then execute the script by ./test then you can see the present working directory.

1
  • 4
    The question was how to ensure the script runs in its own directory, including if that is not the working directory. So this is not an answer. Anyway, why do this instead of just... running pwd? Seems like a lot of wasted keypresses to me. Oct 23, 2016 at 19:01

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.