107

I am running Jenkins from user jenkins thats has $PATH set to something and when I go into Jenkins web interface, in the System Properties window (http://$host/systemInfo) I see a different $PATH.

I have installed Jenkins on Centos with the native rpm from Jenkins website. I am using the startup script provided with the installation using sudo /etc/init.d/jenkins start

Can anyone please explain to me why that happens?

4
  • 1
    If you login as jenkins, and echo $PATH, does it match what you see in jenkins? Apr 28, 2011 at 12:21
  • 3
    @Dave no, it doesnt match. can't understand why
    – Michael
    Apr 28, 2011 at 12:25
  • 8
    The reason it doesn't match is because when you login as the jenkins user you're invoking a login shell, whereas jenkins just executes /bin/sh -xe {your script} so it doesn't run through the same set of scripts that alter the PATH environment variable. In fact, the set of scripts does vary according to the particular flavour of *nix and/or shell that you have installed. I've tested on AWS Linux AMI with jenkins and sadly none of /etc/profile /etc/profile.d/xxx.sh /etc/bashrc /etc/environment ~/.bash_profile ~/.profile ~/.bashrc were able to affect the PATH passed to /bin/sh
    – Luke
    Sep 4, 2015 at 8:03
  • I did a much simpler change, adding it here since it is not stated in any of the answers. STEP1 : Run this command in your jenkins slave which aws , it will return a value similar to /usr/local/bin/aws . STEP2 : In your groovy script where you are making the CLI call, instead of aws just use /usr/local/bin/aws and it overrides all the other variables. I recommend this instead of modifying files inside the slave or jenkins global parameters.
    – mdabdullah
    May 1, 2022 at 0:59

22 Answers 22

151

Michael,

Two things:

When Jenkins connects to a computer, it goes to the sh shell, and not the bash shell (at least this is what I have noticed - I may be wrong). So any changes you make to $PATH in your bashrc file are not considered.

Also, any changes you make to $PATH in your local shell (one that you personally ssh into) will not show up in Jenkins.

To change the path that Jenkins uses, you have two options (AFAIK):

1) Edit your /etc/profile file and add the paths that you want there

2) Go to the configuration page of your slave, and add environment variable PATH, with value: $PATH:/followed-by/paths/you/want/to/add

If you use the second option, your System Information will still not show it, but your builds will see the added paths.

11
  • 2
    This answer worked for me, but I noticed that Jenkins is very sensitive about what you write into the configuration page. I couldn't get it to work with paths with spaces. Oct 23, 2012 at 9:10
  • Yes it is, but when you enter paths with spaces in a UNIX shell, the space is normally escaped with a `` character. Therefore, if your path is "/opt/bin/My Folder Name", you may want to try "/opt/bin/My\ Folder\ Name" instead. This will escape the spaces and allow you to use them.
    – Sagar
    Oct 23, 2012 at 13:13
  • 12
    The solution 2 is the way to go.
    – gagarine
    Oct 3, 2013 at 12:17
  • 2
    Follow-up: on my Ubuntu system, the jenkins service is an upstart job, so I was modifying the old sysvinit stub script. Wrong place. When I tweak the /etc/init/jenkins.conf script, and update the PATH before it exec's java, that does seem to work.
    – Stabledog
    Jan 2, 2014 at 16:40
  • 17
    There is a small dark corner: The jenkins master caches the environment variables from slaves in order to patch the customizations. So if you change environment variables on a slave (system or user), you need to restart the master to update the slaves config.
    – Thinkeye
    Mar 25, 2015 at 8:38
39

I kept running into this problem, but now I just add:

source /etc/profile

As the first step in my build process. Now all my subsequent rules are loaded for Jenkins to operate smoothly.

5
  • 6
    Huh? In detail, please... you add where? how? when? Does it work on Windows? Oct 3, 2012 at 8:06
  • 1
    I assume you're running a shell command as part of your build. Put source /etc/profile as the first command in that Build > Execute Shell > Command textarea. Oct 3, 2012 at 15:12
  • 3
    It works on Mac, also I found paths like /usr/local/bin is specified in /etc/paths, and /etc/paths is used by /usr/libexec/path_helper, and path_helper is executed in /etc/profile.
    – hiroshi
    Nov 28, 2012 at 2:37
  • 1
    you saved my day :)
    – RameshVel
    May 27, 2016 at 10:54
  • Sourcing /etc/profile does show the path when adding a debug of 'echo $PATH' in the job, but if I look at the environment variables for the job it is not the same. Apr 19, 2018 at 21:08
26

You can also edit the /etc/sysconfig/jenkins file to make any changes to the environment variables, etc. I simply added source /etc/profile to the end of the file. /etc/profile has all all of the proper PATH variables setup. When you do this, make sure you restart Jenkins

/etc/init.d/jenkins restart

We are running ZendServer CE which installs pear, phing, etc in a different path so this was helpful. Also, we don't get the LD_LIBRARY_PATH errors we used to get with Oracle client and Jenkins.

2
  • This is a key comment, or restart jenkins from {jenkins-url}/restart or {jenkins-url}/safeRestart . I was banging my head on why path changes were not picked up, by editing even /etc/environment on ubuntu host - RESTART will fix it, as verified by {jenkins-url}/systemInfo
    – kert
    Aug 12, 2014 at 20:10
  • 1
    All the others failed, this is the only one what worked! I wish it were more prevalent so I would not have wasted the last few hours! Apr 16, 2015 at 19:00
17

I tried /etc/profile, ~/.profile and ~/.bash_profile and none of those worked. I found that editing ~/.bashrc for the jenkins slave account did.

1
  • 5
    that's because non-login shell doesn't read neither /etc/profile nor ~/.profile
    – Vincenzo
    Feb 19, 2017 at 12:06
9

The information on this answer is out of date. You need to go to Configure Jenkins > And you can then click to add an Environment Variable key-value pair from there.

eg: export MYVAR=test would be MYVAR is the key, and test is the value.

5

I found two plugins for that. One loads the values from a file and the other lets you configure the values in the job configuration screen.

Envfile Plugin — This plugin enables you to set environment variables via a file. The file's format must be the standard Java property file format.

EnvInject Plugin — This plugin makes it possible to add environment variables and execute a setup script in order to set up an environment for the Job.

5

On my newer EC2 instance, simply adding the new value to the Jenkins user's .profile's PATH and then restarting tomcat worked for me.

On an older instance where the config is different, using #2 from Sagar's answer was the only thing that worked (i.e. .profile, .bash* didn't work).

4

Couldn't you just add it as an environment variable in Jenkins settings:

Manage Jenkins -> Global properties > Environment variables: And then click "Add" to add a property PATH and its value to what you need.

1
  • 1
    Seems to be "Manage Jenkins -> Configure System -> Environment Variables" in version 1.620.
    – akaihola
    Apr 21, 2016 at 14:47
4

This is how I solved this annoying issue:

I changed the PATH variable as @sagar suggested in his 2nd option, but still I got different PATH value than I expected.

Eventually I found out that it was the EnvInject plugin that replaced my PATH variable!

So I could either uninstall EnvInject or just use it to inject the PATH variable.

As many of our Jenkins jobs use that plugin, I didn't want to uninstall it...

So I created a file: environment_variables.properties under my Jenkins home directory.

This file contained the path environment value that I needed: PATH=$PATH:/usr/local/git/bin/.

From the Jenkins web interface: Manage Jenkins -> Configure System. In that screen - I ticked the Prepare jobs environment option, and in the Properties File Path field I entered the path to my file: /var/lib/jenkins/environment_variables.properties.

This way every Jenkins job we have receive whatever variables I put in this environment_variables.properties file.

1
  • 1
    This should be the correct answer. As stated updating /etc/profile is not a feasible solution on OSX as the file is read only and requires messing around with permissions. This solution seems the cleanest and utilises already existing plugins on Jenkins. Remember to restart jenkins once you create your properties file and set it on Jenkins
    – Ransom
    Nov 22, 2016 at 14:29
3

Jenkins also supports the format PATH+<name> to prepend to any variable, not only PATH:

Global Environment variables or node Environment variables:

Jenkins variable + notation

This is also supported in the pipeline step withEnv:

node {
  withEnv(['PATH+JAVA=/path/to/java/bin']) {
    ...
  }
}

Just take note, it prepends to the variable. If it must be appended you need to do what the other answers show.

See the pipeline steps document here.

You may also use the syntax PATH+WHATEVER=/something to prepend /something to $PATH

Or the java docs on EnvVars here.

2

I only had progress on this issue after a "/etc/init.d/jenkins force-reload". I recommend trying that before anything else, and using that rather than restart.

1
  • 1
    And where did you actually add the PATH element? I've tried every place I can imagine.
    – Stabledog
    Jan 2, 2014 at 16:34
2

On my Ubuntu 13.04, I tried quite a few tweaks before succeeding with this:

  1. Edit /etc/init/jenkins.conf
  2. Locate the spot where "exec start-stop-server..." begins
  3. Insert the environment update just before that, i.e.

export PATH=$PATH:/some/new/path/bin

2

Add

/usr/bin/bash

at

Jenkins -> Manage Jenkins -> configure System -> Shell->Shell executable

Jenkins use the sh so that even /etc/profile doesn't work for me When I add this, I have all the env.

1
  • What version of Jenkins did this work for you @sumang_87? It failed to help me on Jenkins 2.9
    – hamx0r
    Feb 8, 2017 at 0:02
1

Solution that worked for me

source ~/.bashrc

Explanation

I first verified Jenkins was running BASH, with echo $SHELL and echo $BASH (note I'm explicitly putting #!/bin/bash atop the textarea in Jenkins, I'm not sure if that's a requirement to get BASH). sourceing /etc/profile as others suggested was not working.

Looking at /etc/profile I found

if [ "$PS1" ]; then
...

and inspecting "$PS1" found it null. I tried spoofing $PS1 to no avail like so

export PS1=1
bash -c 'echo $PATH'

however this did not produce the desired result (add the rest of the $PATH I expect to see). But if I tell bash to be interactive

export PS1=1
bash -ci 'echo $PATH'

the $PATH was altered as I expected.

I was trying to figure out how to properly spoof an interactive shell to get /etc/bash.bashrc to load, however it turns out all I needed was down in ~/.bashrc, so simply sourceing it solved the problem.

1
  • Make sure to use #!/bin/bash -el to tell bash to start up as a login shell. That should cause bash to source the necessary .rc files
    – Brandon
    May 17, 2018 at 17:25
1

I tried all the things from above - didn't work for me.

I found two solution (both for SSH-Slave)

  1. Go to the slave settings

  2. Add a new environment variable

  3. PATH
  4. ${PATH}:${HOME}/.pub-cache/bin:${HOME}/.local/bin

The "${HOME}" part is important. This makes the additional PATH absolute. Relative path did not work for me.

Option II (pipeline-script)

pipeline {
    agent {
        label 'your-slave'
    }
    environment {
        PATH = "/home/jenkins/.pub-cache/bin:$PATH"
    }
    stages {
        stage('Test') {
            steps {
                ansiColor('xterm') {
                    echo "PATH is: $PATH"
                }
            }
        }
    }
}
0

On Ubuntu I just edit /etc/default/jenkins and add source /etc/profile at the end and it works to me.

0

Running the command with environment variable set is also effective. Of course, you have to do it for each command you run, but you probably have a job script, so you probably only have one command per build. My job script is a python script that uses the environment to decide which python to use, so I still needed to put /usr/local/bin/python2.7 in its path:

PATH=/usr/local/bin <my-command>
0

What worked for me was overriding the PATH environment for the slave.

Set:   PATH 
To:    $PATH:/usr/local/bin

Then disconnecting and reconnecting the slave.

Despite what the system information was showing it worked.

0

I have Jenkins 1.639 installed on SLES 11 SP3 via zypper (the package manager). Installation configured jenkins as a service

 # service jenkins
 Usage: /etc/init.d/jenkins {start|stop|status|try-restart|restart|force-reload|reload|probe}

Although /etc/init.d/jenkins sources /etc/sysconfig/jenkins, any env variables set there are not inherited by the jenkins process because it is started in a separate login shell with a new environment like this:

startproc -n 0 -s -e -l /var/log/jenkins.rc -p /var/run/jenkins.pid -t 1 /bin/su -l -s /bin/bash -c '/usr/java/default/bin/java -Djava.awt.headless=true -DJENKINS_HOME=/var/lib/jenkins -jar /usr/lib/jenkins/jenkins.war --javaHome=/usr/java/default --logfile=/var/log/jenkins/jenkins.log --webroot=/var/cache/jenkins/war --httpPort=8080 --ajp13Port=8009 --debug=9 --handlerCountMax=100 --handlerCountMaxIdle=20 &' jenkins

The way I managed to set env vars for the jenkins process is via .bashrc in its home directory - /var/lib/jenkins. I had to create /var/lib/jenkins/.bashrc as it did not exist before.

0

1- add to your profil file".bash_profile" file

it is in "/home/your_user/" folder

vi .bash_profile

add:

export JENKINS_HOME=/apps/data/jenkins  
export PATH=$PATH:$JENKINS_HOME

==> it's the e jenkins workspace

2- If you use jetty : go to jenkins.xml file

and add :

<Arg>/apps/data/jenkins</Arg>
0

Here is what i did on ubuntu 18.04 LTS with Jenkins 2.176.2

I created .bash_aliases file and added there path, proxy variables and so on.

In beginning of .bashrc there was this defined.

# If not running interactively, don't do anything
case $- in
    *i*) ;;
      *) return;;
esac

So it's checking that if we are start non-interactive shell then we don't do nothing here.

bottom of the .bashrc there was include for .bash_aliases

# Alias definitions.
# You may want to put all your additions into a separate file like
# ~/.bash_aliases, instead of adding them here directly.
# See /usr/share/doc/bash-doc/examples in the bash-doc package.

if [ -f ~/.bash_aliases ]; then
    . ~/.bash_aliases
fi

so i moved .bash_aliases loading first at .bashrc just above non-interactive check.

This didn't work first but then i disconnected slave and re-connected it so it's loading variables again. You don't need to restart whole jenkins if you are modifying slave variables. just disconnect and re-connect.

0

If your pipeline is executed on the remote node that is connected via SSH, then actually Jenkins runs agent application that performs incoming actions.

By default zsh shell is used, not the bash (my Jenkins has version 2.346.3).

Furthermore jenkins-agent runs non-login shell which makes default PATH values even if you put some configuration to .zshrc. It will be skipped.

My choice is to put the following shebang at a script start

#!/bin/bash -l

-l option makes bash to run in the login mode and in this case bash performs configurations specified in /etc/profile and ~/.bash_profile.

If you run script in Jenkins pipeline it will look like:

steps {
  sh '''#!/bin/bash -l
    env
  '''
}

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.