Start/Kill appium server within java code

Hi! I am thinking about it!
I think that it is not correct to communicate with Appium UI app. The correct way is to launch/kill node by itself.

Only NodeJS! Only hardcore!

Actually I was thinking about implementation of the standalone maven artifact for Appium/java-client package which could provide ability to launch Appium nodeJS server programmatically. There is an API which can help to achive this. Slideshare.

But it requires java 8. I think @jonahss doesn’t appriciate migration of the java-client to java 8 for now. So it should be the standalone artifact.

I am interested too…

Refer to this topic for help.

Thanks Hasan!
i will first try to run it from terminal (i am using Mac) & once this will work we will formalize it to code.
So according your previous post i need to run the below in the terminal right?
Few questions:

  • I guess my UI is irrelevant for this right?
  • so i download the 1.3.1 from github & i want to use /bin/sh with the relevant command as you post.
    i can see in the Appium.js file however i am not sure what is the equivalent path to the windows node.exe on mac?
    Thanks in advance for your help…

“cmd /c “C:/Program Files (x86)/Appium/node.exe” “C:/Program Files (x86)/Appium/node_modules/appium/bin/Appium.js” --address --chromedriver-port 9516 --bootstrap-port 4725 --selendroid-port 8082 --no-reset --local-timezone”

I tried this in the past and I’ve started from running a shell command from Java app. I was thinking to start appium in a separate thread…
After some research I have this:

public class RuntimeExec {
    public StreamWrapper getStreamWrapper(InputStream is, String type){
        return new StreamWrapper(is, type);
    private class StreamWrapper extends Thread {
        InputStream is = null;
        String type = null;
        String message = null;

        StreamWrapper(InputStream is, String type) {
   = is;
            this.type = type;

        public void run() {
            try {
                BufferedReader br = new BufferedReader(new InputStreamReader(is));
                StringBuffer buffer = new StringBuffer();
                String line = null;
                while ( (line = br.readLine()) != null) {
                message = buffer.toString();
            } catch (IOException ioe) {
    // this is where the action is
    public static void startAppium(String comand) {
        Runtime rt = Runtime.getRuntime();
        RuntimeExec rte = new RuntimeExec();
        StreamWrapper error, output;

        try {
            Process proc = rt.exec(comand);
            error = rte.getStreamWrapper(proc.getErrorStream(), "ERROR");
            output = rte.getStreamWrapper(proc.getInputStream(), "OUTPUT");
            int exitVal = 0;

            BufferedReader stdInput = new BufferedReader(new InputStreamReader(proc.getInputStream()));
            String s;
            while((s = stdInput.readLine()) != null){
                if(s.contains("Appium REST http")){

            exitVal = proc.waitFor();
            System.out.println("Output: "+output.message+"\nError: "+error.message);
        } catch (IOException e) {
        } catch (InterruptedException e) {

What remains is to start appium like this:

RuntimeExec appiumObj = new RuntimeExec();

Not sure if it is the correct approach, but it seems to be working :smile:

1 Like
public class SampleJavaTest {
private static Process process;
private static String APPIUMSERVERSTART = "node /home/adminuser/Java_Projects/Appium/appium";    

public static void startAppiumServer() throws IOException, InterruptedException {
    Runtime runtime = Runtime.getRuntime();
    process = runtime.exec(APPIUMSERVERSTART);
    if (process != null) {
        System.out.println("Appium server started");

public static void stopAppiumServer() throws IOException {
    if (process != null) {
    System.out.println("Appium server stop");

public static void main(String args[]) throws IOException, InterruptedException {        


  • You either run it from the terminal or automate the process of that using Java as I mentioned in this post.
  • If you are gonna use the donwnloaded UI Appium, then its location on your system is very relevant as you have to include that location when starting the server. If you are gonna download the Github version of Appium, then the UI Appium is irrelevant in this case and you just need to refer to the location of the Github repository.
  • The answer is there.

Hi Priyank_Shah,
Thanks for the code sample however this is that exact code i used but i am missing the following:

  • What is the path i should give for the runtime.exec()

Since i am using direct code from my local repo. hence i gave to “node </home/adminuser/Java_Projects/Appium/appium>”. you can use the directory where your appium is stored.
If you had installed appium using brew. then you just need to invoke “appium” command in runtime.exec(APPIUMCOMMAND).

Priyank Shah

Hi Hassan i was able to start the server via terminal as you suggested!!!
i saw posts how to implement it by CommandLine command = new CommandLine(“cmd”);
what is the practice on mac? (i want to start stop the server via code naturally)

On Mac, it should be similar, but you have to change

CommandLine command = new CommandLine(“cmd”);

to be:

CommandLine command = new CommandLine("/bin/sh");

1 Like

What about the using of environment variables? We can reach agreement about system variable name, unify all drafts above and propose a new pull request.

But firstly…
I have a question. Anybody knows how to get appium node state? Port of the node which is already launched?

I think if you can check using “netstat -anp | grep <appium_port>” using java code.

It needs to think about…

I am thinking about these variants… AndroidDriver and IOSDriver require remote URL. If node has been launched automatically or before test script is started they need to know port. If we could receive actual port number we would use:

new AndroidDriver(Capabilities);
new IOSDriver(Capabilities);

What are you think about it? Above is for the local starting.

I think to remote starting, the same daemon process you need to run (using ssh) that will give you port numbers.

You can use the following command to accomplish that:

echo off & FOR /F “usebackq tokens=2” %a in (TASKLIST ^| findstr /I node.exe) do (FOR /F “usebackq tokens=2” %b in (netstat -nao ^| findstr /R /C:"%a") do echo %b)

Run it from inside your Java application, parse the returned value and get the port number from it :smile:

1 Like

Thanks for suggestions! I will try it.

I tried your suggestion for starting appium server through the following java code.
Somehow the server is not starting.When i check using the command sudo lsof -i :4723 there are no process running on the port 4723.
But when i try the same command manually in a terminal without /bin/sh the server starts successfully
Am i missing something here?

I am using Java 8 , Xcode 6.1 , MAC 10.10, Appium 1.3.1

public class Runner {

static String APPIUMCOMMAND = “/bin/sh /Applications/ /Applications/ --address --port 4723”;

public static void main(String[] args) throws ExecuteException, IOException {

public static void startAppiumServer() throws ExecuteException, IOException {

DefaultExecuteResultHandler resultHandler = new DefaultExecuteResultHandler();
Executor executor = new DefaultExecutor();
executor.execute(new CommandLine(APPIUMCOMMAND), resultHandler);

Thanks in advance for your time.
Regards Srinidhi

See this for help…

Hi folks first of all thanks for helping me overcome this obstacle.
at the end my solution for starting & stopping the Appium server was simple,
i created 2 shell scripts files, one for starting the server & the other for stopping it.

Start server file include the following data:
/Applications/ /Applications/ --address --chromedriver-port 9516 --bootstrap-port 4725 --no-reset --local-timezone

Stop server file include the following data:
killall node

The java code for starting & Stopping the server was:
//Start Appium server
//Stop Appium server

Hope it helps future developers!!!

1 Like


I have to start and stop appium server (node) on mac machine using java code from a windows machine

is it possible and if it so can i have the code pls
Thanks in advance