207

I have a bash script like:

#!/bin/bash

echo Hello world!

How do I execute this in Terminal?

1
  • 39
    Does it have execute permissions? Try a chmod +x scriptname and then ./scriptname. Commented Feb 1, 2010 at 15:53

9 Answers 9

213

Yet another way to execute it (this time without setting execute permissions):

bash /path/to/scriptname
Sign up to request clarification or add additional context in comments.

3 Comments

had a seperate issue (trying to install anaconda via terminal on mac) and this was the solution. only thing I had to do was close and restart the shell, follow the one step here (/(your conda installation path)/bin/conda init zsh) and then close and reopen the shell one more time
Excuse my ignorance but what's the difference between using and not using bash before the path?
@AlexD: If the script is not both marked as executable (e.g. chmod +x) and has a shebang (e.g. the first line is similar to #!/bin/bash) then the interpreter needs to be specified. Thus bash (or another interpreter) is used.
72

$prompt: /path/to/script and hit enter. Note you need to make sure the script has execute permissions.

1 Comment

If you already are in the /path/to directory, e.g. with the cd /path/to command, you can enter ./script to run your script.Don't forget, in this case the './' before 'script'
49

cd to the directory that contains the script, or put it in a bin folder that is in your $PATH

then type

./scriptname.sh

if in the same directory or

scriptname.sh

if it's in the bin folder.

3 Comments

This will only work if the script has the execute bit set. That probably needs to be addressed.
./scriptname.sh works for me but scriptname.sh gives scriptname.sh: command not found. -rwxr-xr-x are its permissions.
The advice to cd anywhere at all perpetrates another common beginner misunderstanding. Unless the script internally has dependencies which require it to run in a particular directory (like, needing to read a data file which the script inexplicably doesn't provide an option to point to) you should never need to cd anywhere to run it, and very often will not want to.
45

This is an old thread, but I happened across it and I'm surprised nobody has put up a complete answer yet. So here goes...

The Executing a Command Line Script Tutorial!

Q: How do I execute this in Terminal?

The answer is below, but first ... if you are asking this question, here are a few other tidbits to help you on your way:

Confusions and Conflicts:

The Path

  • Understanding The Path (added by tripleee for completeness) is important. The "path" sounds like a Zen-like hacker koan or something, but it is simply a list of directories (folders) that are searched automatically when an unknown command is typed in at the command prompt. Some commands, like ls may be built-in's, but most commands are actually separate small programs. (This is where the "Zen of Unix" comes in ... "(i) Make each program do one thing well.")

Extensions

  • Unlike the old DOS command prompts that a lot of people remember, you do not need an 'extension' (like .sh or .py or anything else), but it helps to keep track of things. It is really only there for humans to use as a reference and most command lines and programs will not care in the least. It won't hurt. If the script name contains an extension, however, you must use it. It is part of the filename.

Changing directories

  • You do not need to be in any certain directory at all for any reason. But if the directory is not on the path (type echo $PATH to see), then you must include it. If you want to run a script from the current directory, use ./ before it. This ./ thing means 'here in the current directory.'

Typing the program name

  • You do not need to type out the name of the program that runs the file (BASH or Python or whatever) unless you want to. It won't hurt, but there are a few times when you may get slightly different results.

SUDO

  • You do not need sudo to do any of this. This command is reserved for running commands as another user or a 'root' (administrator) user. Running scripts with sudo allows much greater danger of screwing things up. So if you don't know the exact reason for using sudo, don't use it. Great post here.

Script location ...

  • A good place to put your scripts is in your ~/bin folder.
  • You can get there by typing
# A good place to put your scripts is in your ~/bin folder.

> cd ~/bin # or cd $HOME/bin

> ls -l

You will see a listing with owners and permissions. You will notice that you 'own' all of the files in this directory. You have full control over this directory and nobody else can easily modify it.

If it does not exist, you can create one:

> mkdir -p ~/bin && cd ~/bin
> pwd

/Users/Userxxxx/bin


A: To "execute this script" from the terminal on a Unix/Linux type system, you have to do three things:

1. Tell the system the location of the script. (pick one)

# type the name of the script with the full path
> /path/to/script.sh

# execute the script from the directory it is in
> ./script.sh

# place the script in a directory that is on the PATH
> script.sh

# ... to see the list of directories in the path, use:
> echo $PATH
/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

# ... or for a list that is easier to read:
> echo -e ${PATH//:/\\n}
# or
> printf "%b" "${PATH//:/\\n}"
/usr/local/sbin
/usr/local/bin
/usr/sbin
/usr/bin
/sbin
/bin

2. Tell the system that the script has permission to execute. (pick one)

# set the 'execute' permissions on the script
> chmod +x /path/to/script.sh

# using specific permissions instead
# FYI, this makes these scripts inaccessible by ANYONE but an administrator
> chmod 700 /path/to/script.sh

# set all files in your script directory to execute permissions
> chmod +x ~/bin/*

There is a great discussion of permissions with a cool chart here.

3. Tell the system the type of script. (pick one)

  • Type the name of the program before the script. (Note: when using this method, the execute(chmod thing above) is not required
> bash /path/to/script.sh
... 

> php /path/to/script.php
... 

> python3 /path/to/script.py
...
  • Use a shebang, which I see you have (#!/bin/bash) in your example. If you have that as the first line of your script, the system will use that program to execute the script. No need for typing programs or using extensions.
  • Use a "portable" shebang. You can also have the system choose the version of the program that is first in the PATH by using #!/usr/bin/env followed by the program name (e.g. #!/usr/bin/env bash or #!/usr/bin/env python3). There are pros and cons as thoroughly discussed here.

Note: This "portable" shebang may not be as portable as it seems. As with anything over 50 years old and steeped in numerous options that never work out quite the way you expect them ... there is a heated debate. The most recent one I saw that is actually quite different from most ideas is the "portable" perl-bang:

#!/bin/sh
exec perl -x "$0" "$@"
#!perl

3 Comments

Pretty good summary. Maybe in the last example remind people that script.sh and script.php are the literal file names of these scripts, and that if you put an extension in the file name, you need to include it when you run the script (and vice versa; if the script doesn't have an extension, don't put one). This is unlike e.g. DOS where you could omit the .bat or .exe from the file name, and files needed to have an extension from a small set in order to be considered executable.
Another common beginner mistake is misunderstanding the difference between path, /path, ./path, and ~/path. I guess you probably don't want to explain it here, but maybe link to an explanation such as ... oh dang, I had to post this.
You don't need to set executable permissions if you specify the interpreter on the command line.
31

You could do:
sh scriptname.sh

11 Comments

Downvote: That's wrong if it's properly a Bash script.
Upvote: This is fine on Mac OS X if your bash script is in the same directory
@kot "It happens to work for me" is very far from "this is a correct answer". It can work if sh is a symlink to bash, or if the script does not use any Bash-specific construct. In the former case, using bash instead of sh is the only correct, portable solution; in the latter case, it's not the correct answer to this particular question, because the OP asked about advice for a Bash script specifically. Perpetrating the wrong answer is irresponsible; users who fail to grasp the difference frequently post here, and need to be shown why this "worked for me" answer did not work for them.
@kraftydevil too ^ One of several popular duplicate targets on this topic: stackoverflow.com/questions/5725296/…
@kot I repeat: There are situations where this works (just like you found out) but it is not a correct answer in the general case to the question in the headline. At the very least, this answer should explain the conditions under which it works; but my suggestion would be to simply delete this answer.
|
20

Firstly you have to make it executable using: chmod +x name_of_your_file_script.

After you made it executable, you can run it using ./same_name_of_your_file_script

Comments

16

Change your directory to where script is located by using cd command

Then type

bash program-name.sh

1 Comment

There is no need to cd anywhere; you can speciy an arbitrarily complex path name as the argument to bash; indeed, any program which takes a file name argument works this way (or is terrifyingly, mind-numbingly broken).
8

And yet one more way

. /path/to/script

What is the meaning of the dot?

1 Comment

This executes the script in the current shell, which needs to be called out. This is not what most people expect to happen when you simply run a script. This can have side-effects on your existing environment.
-4

If you are in a directory or folder where the script file is available then simply change the file permission in executable mode by doing

chmod +x your_filename.sh

After that you will run the script by using the following command.

$ bash ./your_filename.sh

Above the "." represent the current directory.

4 Comments

Hope fully all will do this because I mention all the related concept about this particular problem.
As explained in other answers here, sudo is wrong and potentially horribly wrong if you use it on an untrusted script which abuses the powers you needlessly gave it.
The advice to cd somewhere is hard to understand, but probably also wrong.
There is no hard requirement to use bash in the second line after specifiying the permissions in the first line with chmod.

Your Answer

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

Start asking to get answers

Find the answer to your question by asking.

Ask question

Explore related questions

See similar questions with these tags.