214

I created two docker containers based on two different images. One of db and another for webserver. Both containers are running on my mac osx.

I can access db container from host machine and same way can access webserver from host machine.

However, how do I access db connection from webserver?

The way I started db container is

docker run --name oracle-db -p 1521:1521 -p 5501:5500 oracle/database:12.1.0.2-ee

I started wls container as

docker run --name oracle-wls -p 7001:7001 wls-image:latest

I can access db on host by connecting to

sqlplus scott/welcome1@//localhost:1521/ORCLCDB

I can access wls on host as

http://localhost:7001/console
4

8 Answers 8

219

It's easy. If you have two or more running container, complete next steps:

docker network create myNetwork
docker network connect myNetwork web1
docker network connect myNetwork web2

Now you connect from web1 to web2 container or the other way round.

Use the internal network IP addresses which you can find by running:

docker network inspect myNetwork

Note that only internal IP addresses and ports are accessible to the containers connected by the network bridge.

So for example assuming that web1 container was started with: docker run -p 80:8888 web1 (meaning that its server is running on port 8888 internally), and inspecting myNetwork shows that web1's IP is 172.0.0.2, you can connect from web2 to web1 using curl 172.0.0.2:8888).

4
  • 4
    Hi, and how do I connect from web1 to web2? by ip, hostname? where to get this info? Commented Jan 8, 2020 at 1:16
  • In file docker-compose.yml create networks: myNetwork.
    – MxWild
    Commented Jan 9, 2020 at 7:16
  • 55
    @HenryÁvila You just use container's name (e.g. web1) as the hostname.
    – Pascal
    Commented Feb 21, 2020 at 22:23
  • You might need to restart the affected containers as well Commented Jan 24, 2023 at 20:10
79

Easiest way is to use --link, however the newer versions of docker are moving away from that and in fact that switch will be removed soon.

The link below offers a nice how too, on connecting two containers. You can skip the attach portion, since that is just a useful how to on adding items to images.

https://web.archive.org/web/20160310072132/https://deis.com/blog/2016/connecting-docker-containers-1/

The part you are interested in is the communication between two containers. The easiest way, is to refer to the DB container by name from the webserver container.

Example:

you named the db container db1 and the webserver container web0. The containers should both be on the bridge network, which means the web container should be able to connect to the DB container by referring to its name.

So if you have a web config file for your app, then for DB host you will use the name db1.

if you are using an older version of docker, then you should use --link.

Example:

Step 1: docker run --name db1 oracle/database:12.1.0.2-ee

then when you start the web app. use:

Step 2: docker run --name web0 --link db1 webapp/webapp:3.0

and the web app will be linked to the DB. However, as I said the --link switch will be removed soon.

I'd use docker compose instead, which will build a network for you. However; you will need to download docker compose for your system. https://docs.docker.com/compose/install/#prerequisites

an example setup is like this:

file name is base.yml

version: "2"
services:
  webserver:
    image: moodlehq/moodle-php-apache:7.1
    depends_on:
      - db
    volumes:
      - "/var/www/html:/var/www/html"
      - "/home/some_user/web/apache2_faildumps.conf:/etc/apache2/conf-enabled/apache2_faildumps.conf"
    environment:
      MOODLE_DOCKER_DBTYPE: pgsql
      MOODLE_DOCKER_DBNAME: moodle
      MOODLE_DOCKER_DBUSER: moodle
      MOODLE_DOCKER_DBPASS: "m@0dl3ing"
      HTTP_PROXY: "${HTTP_PROXY}"
      HTTPS_PROXY: "${HTTPS_PROXY}"
      NO_PROXY: "${NO_PROXY}"
  db:
    image: postgres:9
    environment:
      POSTGRES_USER: moodle
      POSTGRES_PASSWORD: "m@0dl3ing"
      POSTGRES_DB: moodle
      HTTP_PROXY: "${HTTP_PROXY}"
      HTTPS_PROXY: "${HTTPS_PROXY}"
      NO_PROXY: "${NO_PROXY}"

this will name the network a generic name, I can't remember off the top of my head what that name is, unless you use the --name switch.

IE docker-compose --name setup1 up base.yml

NOTE: if you use the --name switch, you will need to use it when ever calling docker compose, so docker-compose --name setup1 down this is so you can have more then one instance of webserver and db, and in this case, so docker compose knows what instance you want to run commands against; and also so you can have more then one running at once. Great for CI/CD, if you are running test in parallel on the same server.

Docker compose also has the same commands as docker so docker-compose --name setup1 exec webserver do_some_command

best part is, if you want to change db's or something like that for unit test you can include an additional .yml file to the up command and it will overwrite any items with similar names, I think of it as a key=>value replacement.

Example:

db.yml

version: "2"
services:
  webserver:
    environment:
      MOODLE_DOCKER_DBTYPE: oci
      MOODLE_DOCKER_DBNAME: XE
  db:
    image: moodlehq/moodle-db-oracle

Then call docker-compose --name setup1 up base.yml db.yml

This will overwrite the db. with a different setup. When needing to connect to these services from each container, you use the name set under service, in this case, webserver and db.

I think this might actually be a more useful setup in your case. Since you can set all the variables you need in the yml files and just run the command for docker compose when you need them started. So a more start it and forget it setup.

NOTE: I did not use the --port command, since exposing the ports is not needed for container->container communication. It is needed only if you want the host to connect to the container, or application from outside of the host. If you expose the port, then the port is open to all communication that the host allows. So exposing web on port 80 is the same as starting a webserver on the physical host and will allow outside connections, if the host allows it. Also, if you are wanting to run more then one web app at once, for whatever reason, then exposing port 80 will prevent you from running additional webapps if you try exposing on that port as well. So, for CI/CD it is best to not expose ports at all, and if using docker compose with the --name switch, all containers will be on their own network so they wont collide. So you will pretty much have a container of containers.

UPDATE: After using features further and seeing how others have done it for CICD programs like Jenkins. Network is also a viable solution.

Example:

docker network create test_network

The above command will create a "test_network" which you can attach other containers too. Which is made easy with the --network switch operator.

Example:

docker run \
    --detach \
    --name db1 \
    --network test_network \
    -e MYSQL_ROOT_PASSWORD="${DBPASS}" \
    -e MYSQL_DATABASE="${DBNAME}" \
    -e MYSQL_USER="${DBUSER}" \
    -e MYSQL_PASSWORD="${DBPASS}" \
    --tmpfs /var/lib/mysql:rw \
    mysql:5

Of course, if you have proxy network settings you should still pass those into the containers using the "-e" or "--env-file" switch statements. So the container can communicate with the internet. Docker says the proxy settings should be absorbed by the container in the newer versions of docker; however, I still pass them in as an act of habit. This is the replacement for the "--link" switch which is going away. Once the containers are attached to the network you created you can still refer to those containers from other containers using the 'name' of the container. Per the example above that would be db1. You just have to make sure all containers are connected to the same network, and you are good to go.

For a detailed example of using network in a cicd pipeline, you can refer to this link: https://git.in.moodle.com/integration/nightlyscripts/blob/master/runner/master/run.sh

Which is the script that is ran in Jenkins for a huge integration tests for Moodle, but the idea/example can be used anywhere. I hope this helps others.

3
  • 2
    If the first link doesn't work, you can use this one. linode.com/docs/applications/containers/… Commented Aug 8, 2019 at 16:03
  • 1
    For Doing Docker compose or doing network, how would the webserver reference the DB? Would it use the name of the container? It looks like in the second link that is the case: So if you define a DB and an APP, the app would have to reference in this case: psql -U {USER} -h database -p 5432 {DATABASE} from within the container if i were shelled into it Commented Oct 4, 2020 at 19:08
  • 1
    @Fallenreaper if you are in the container and did docker compose you would use the name, used under "services:" if you didn't explicitly give it a name. So in the example you would use "webserver" if you were trying to connect from the "db" container in the shell. Look at example for db.yml you would use the names webserver and db. Sorry for the delay got sidetracked and forgot the notice. Commented Oct 22, 2020 at 15:40
42

You will have to access db through the ip of host machine, or if you want to access it via localhost:1521, then run webserver like -

docker run --net=host --name oracle-wls wls-image:latest

See here

5
  • 1
    how will this work in real life as ip of host will change based on which machine containers are running.
    – Vik
    Commented Feb 23, 2017 at 1:01
  • 1
    That is valid only if machine has static ip or DNS, else go with the second approach.
    – xitter
    Commented Feb 23, 2017 at 12:23
  • i seems to have issue with this. my exact run command is: docker run --name ora-tools-wls -it -p 7001:7001 orawls this works and let me access my server running on this container as localhost:7001/console However, the db access from server need exact ip to reach another container running the DB. If I go with docker run --name ora-tools-wls -it -p 7001:7001 --network="host" orawls then server is able to access db with localhost as ip as you mentioned but access server in host machine browser fails.
    – Vik
    Commented Feb 24, 2017 at 6:08
  • 4
    You don't need to define -p 7001:7001, as all container is using the host's network stack itself.
    – xitter
    Commented Feb 25, 2017 at 7:23
  • 1
    @Vik , I had the same trouble and found that it isn't supported on the mac. maybe that is what you are doing as well. > The host networking driver only works on Linux hosts, and is not supported on Docker Desktop for Mac, Docker Desktop for Windows, or Docker EE for Windows Server. docs.docker.com/network/host Commented Oct 22, 2020 at 3:40
30

Using docker-compose, services are exposed to each other by name by default. Docs.
You could also specify an alias like;

version: '2.1'
services:
  mongo:
    image: mongo:3.2.11
  redis:
    image: redis:3.2.10
  api:
    image: some-image
    depends_on:
      - mongo
      - solr
    links:
      - "mongo:mongo.openconceptlab.org"
      - "solr:solr.openconceptlab.org"
      - "some-service:some-alias"

And then access the service using the specified alias as a host name, e.g mongo.openconceptlab.org for mongo in this case.

2
  • 1
    Thanks for shooting the documentation! :)
    – wei
    Commented May 3, 2021 at 2:51
  • 2
    Yes, I read that in several sources. Unfortunately, all those sources don't continue to the point where I can make any use of the information. For example, no one says how I can construct a valid http URL using the service name. http://api/ simply does not work (obviously).
    – MDickten
    Commented Oct 7, 2022 at 9:43
27

Environment: Windows 10, Docker Desktop version 4.5.1.

Use hostname host.docker.internal to access services running on your host machine from inside a container.

See: https://docs.docker.com/desktop/windows/networking/#use-cases-and-workarounds

I run PostgreSQL in one container and my app in a separate container. I configure the app database connection to use host.docker.internal as the hostname and it just works.

Notes:

  • when accessing host.docker.internal from inside a container, you're accessing the "host" so you want to use the port that you published the container on
  • Using host.docker.internal as a hostname does not work by default on Linux systems. On Linux, you need to add --add-host=host.docker.internal:host-gateway to the run command of the container that is trying to resolve host.docker.internal.
1
  • 1
    Nice solution for local development, you don't have to deal with the external network this way.
    – Scofield
    Commented Feb 13, 2023 at 18:34
6

Consider Example We Create two containers here PostgreSQL server and pgadmin(for accessing servers like PHPMyAdmin, SQL studio, workbench).

enter image description here

Exposed port

  1. PostgreSql --->5436
  2. Pgadmin --->5050

After adding a server in pgadmin hostname as localhost.It will show a connection error. Because Docker container pgadmin getting localhost as their system instead we need PostgreSQL IP to solve the problem.

enter image description here

docker network create con
docker network connect con app1
docker network connect con app2

enter image description here

This command gets connected container IP address and other details.

docker network inspect con

enter image description here

Now you can see the IP address shown in the network inspect. Choose the Postgres container IP. You can access other exposed ports through this IP. Here postgre 5432 is only exposed.Now set hostname as the container ip and it will work.

1

You can use the default docker network. If you don't want to go through any docker networking, you can do this:

Copy the ip address in Docker subnet in Resources>Network in Docker Preferences in Mac: Docker preferences screenshot

As you can see from the screenshot link the ip address is

192.168.65.0

You just need to replace “localhost” in your containers config file with “192.168.65.1" (i.e. IP address picked + 1 ).

You can start your containers and should be set for local development/testing.

For some more details, you can see my article: Connect Docker containers the easy way

0

In my case, the host connection in the application to a container from an other container by the IP provide by the bridge didn't work.

But it works with the name of the container (see my screenshot).

So you can replace the IP by the name of the container.

enter image description here

Your Answer

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

Not the answer you're looking for? Browse other questions tagged or ask your own question.