Luke101
Luke101

Reputation: 65308

How to run a docker container if not already running

I need to run a docker container only if its not already running. Given this command. How would I run it only if it does not exists.

docker run --name nginx -d nginx

I am open to any script or language.

Upvotes: 58

Views: 39660

Answers (6)

Prahas.Code
Prahas.Code

Reputation: 1

#!/bin/bash
# Define variables
IMAGE_NAME="hello-world:latest"
CONTAINER_NAME="hello-world-container"

[[ $(docker ps -al -f name=$CONTAINER_NAME --format '{{.Names}}') == $CONTAINER_NAME ]] ||
docker run -d --name $CONTAINER_NAME $IMAGE_NAME

works

Upvotes: 0

Jim Sangwine
Jim Sangwine

Reputation: 56

I know I'm late to the party, but this works fine for me:

docker ps | grep nginx >/dev/null || docker run nginx

Upvotes: 1

christian c
christian c

Reputation: 31

If the purpose is idempotency and the container in question is fungible (as is the case in your example), then the current state of the system (is/was it running) doesn't matter.

On a blank slate.

$ docker ps -a --format '{{.Names}}' | wc -l
0

Performing force remove and create when a container exists.

$ docker run --name=hello -d alpine sleep inf
0f6175804d69d48cdada66de57cb62c2855d1085c08a69f21e782c433be2c6a2
$ docker ps --format '{{.Names}}'
hello
$ docker rm -f hello ||:
hello
$ docker run --name=hello -d alpine sleep inf 
...

Is exactly the same as when it doesn't.

$ docker ps -a --format '{{.Names}}' | wc -l
0
$ docker rm -f hello 2>/dev/null ||:
$ docker run --name=hello -d alpine sleep inf
d0210fefc7e934fea6d669615538596cf372f15e9095edae81c35965ff021898

Is exactly the same when performing a conditional check.

$ docker ps -a --format '{{.Names}}'
hello
$ if ! docker ps -a --format '{{.Names}}' | grep hello >/dev/null ;then 
> docker run --name=hello -d alpine sleep inf 
> fi
$ docker rm -f hello
hello
$ if ! docker ps -a --format '{{.Names}}' | grep hello >/dev/null ;then 
> docker run --name=hello -d alpine sleep inf 
> fi
1edcbba0c01979edbe05072bd3c15b6ecfb129d9e20d45a33eff0921cc5f2ed3

Which makes force-remove/create an idempotent operation, where our guarantee of state, post operation, makes conditionals pointless and crufty.

If your container has to observe some underlying state, well, then forget all of this.

Upvotes: 3

Eugen Mayer
Eugen Mayer

Reputation: 9934

I would definitely suggest looking into docker-compose and docker-compose up as answered above.

Since your question is about docker run, i would simplify the answer of VonC like this

docker start nginx || docker run --name nginx -d nginx

If the container already is running, docker start will return 0 thus no docker run is executed. If the container EXISTS but is not running, docker start will start it, otherwise it docker run creates and starts it in one go.

The "exists but stopped" part is missing in VonC's answer.

Upvotes: 113

VonC
VonC

Reputation: 1328202

Use a filter to check if a container of a certain name exists:
(See docker ps Filterring)

#!/bin/bash

name='nginx'

[[ $(docker ps -f "name=$name" --format '{{.Names}}') == $name ]] ||
docker run --name "$name" -d nginx

The docker run will only be executed if the first part is false.

To be on the safe side (docker ps might return several names), you might alternatively do (if you think the word "nginx" can't be part of any container name):

if ! docker ps --format '{{.Names}}' | grep -w nginx &> /dev/null; then
    docker run --name nginx -d nginx
fi

Or:

if ! docker ps --format '{{.Names}}' | egrep '^nginx$' &> /dev/null; then
    docker run --name nginx -d nginx
fi

Upvotes: 34

Carlos Rafael Ramirez
Carlos Rafael Ramirez

Reputation: 6234

Well if you are open to any language I recommend using docker-compose for this task. After installing it, create a file called docker-compose.yml with this content:

version: '2'
services:
  nginx:
    image: 'nginx' 

Then use:

docker-compose up -d

It will always check if the container is already running. If the container doesn't exists it will create it and run. If the container is stopped it just run it.

The best thing is if you alter the docker-compose.yml or pull a new version of the image it will automatically recreate the container preserving all volumes even the unnamed ones.

Regards

Upvotes: 8

Related Questions