--- title: Overview of 'docker run' slug: manufacturing-connect-edge-v1/overview-of-docker-run docTags: createdAt: 2023-09-27T14:36:02.816Z --- You can run custom images in Docker containers within Manufacturing Connect Edge (MC Edge). The Docker command used for this purpose is `docker run` and several options can be passed to this command to change its behavior. In this section, you will view some examples of how the `docker run` command can be used to run a Docker container in MC Edge. :::hint{type="info"} **Notes:** - The Docker run command is a very versatile tool with numerous configuration options. This section is only intended as an introduction to some of the possible uses of `docker run`. It does not serve as a comprehensive reference. See the [Docker documentation](https://docs.docker.com/engine/reference/commandline/run/) for the official, maintained and complete description of `docker run` and its capabilities. - The **Run **button in the *Containers* pane can only be used for `docker run` commands. Other commands, including any other `docker` commands, cannot be used. ::: The most basic example of a `docker run` command is `docker run `, where `` is the path to the image to be run in Docker. To use options to modify the behavior of `docker run`, insert the option between `docker run` and the path to the image. `docker run -d ` adds the `-d` option, for example. This is called 'passing' the option to the (`docker run`) command. **To run a custom Docker image:** 1. Log in to Manufacturing Connect Edge. 2. From the navigation panel, select **Applications.** The *Dashboard* pane appears. 3. Click **Containers** in the navigation sub-panel. The *Containers* pane appears. 4. Click **Run **at the upper right corner of the pane. The *Enter command* to run text field appears. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/8jPpuaq5TzGFrvGAxmiC7_runbutton.png) 5. Enter the `docker run` command you wish to run into the field. 6. Click **Run.** The command runs and the custom image container is created. This section covers the use of the following options: - `-d` or `--detach` - `--restart ` - `-it` - `--expose` or `-p` - `--volume` - `-e` ## Detach Pass the `-d` or `--detach` option to `docker run` to run the Docker container in the background. :::hint{type="warning"} **Important: **Using the `-d` option is mandatory to run a Docker container in MC Edge. ::: ## Restart There are several ways the `--restart` option can be passed to `docker run`. :::hint{type="info"} **Note: **The typical approach is to pass `--restart always`. If this option is not set (or set differently), the container will have to be started again manually after the MC Edge instance is rebooted. ::: ## Interactive bash Shell and TTY The `-it` option, when passed to `docker run`, starts an interactive `bash` shell in the container and allows the user to interact with said shell through a pseudo-TTY. This is a combination of the `-t` and `-i` options (short for `--tty` and `--interactive` respectively). ## Expose and/or Publish Ports The `--expose` option allows the user to expose one or several ports of the container. Similarly, `-p` (short for `--publish`) publishes a container's port or ports to the host device. These options are passed by following an option by `:` or just ``. For example, port `X` could be exposed by passing the option `--expose X` to `docker run`. See [System Requirements](docId:_3LCvN9ni8YqID3ZMadg5) to review the list of required and optional ports. ## Bind Mount a Volume You can mount and bind a volume into the container by using the `--volume` option ( `-v` for short). The general syntax is `--volume :`. ## Set Environment Variables You can set environment variables in the container by passing the `--env` option ( `-e` for short). The syntax is `--env =`, where `` is generally in all capital letters.