---
title: Docker Network Settings
description: Resolve common network configuration issues for Docker, including Mac ARM-based and locahost errors related to the Timebase components
---

[Skip to content](https://docs.timebase.flow-software.com/knowledge-base/docker-network-settings#main-content)

[More support](https://docs.timebase.flow-software.com/knowledge-base/kb-tickets/new?hsLang=en)

[![FlowEmailHeader](https://docs.timebase.flow-software.com/hs-fs/hubfs/FlowEmailHeader.png?width=120&height=33&name=FlowEmailHeader.png)](https://flow-software.com/)

Open main navigation

Close main navigation

- [More support](https://docs.timebase.flow-software.com/knowledge-base/kb-tickets/new)
- [Open a Support Ticket](https://docs.timebase.flow-software.com/knowledge-base/kb-tickets/new)

[Open a Support Ticket](https://docs.timebase.flow-software.com/knowledge-base/kb-tickets/new?hsLang=en)

 Search all Timebase documentation

- There are no suggestions because the search field is empty.

1. [Timebase Knowledge Base](https://docs.timebase.flow-software.com/knowledge-base?hsLang=en)
2. [Timebase Quick Start](https://docs.timebase.flow-software.com/knowledge-base/timebase-quick-start?hsLang=en)
3. [Advanced Topics](https://docs.timebase.flow-software.com/knowledge-base/timebase-quick-start?hsLang=en#advanced-topics)

# Docker Network Settings

## Resolve common network configuration issues for Docker, including Mac ARM-based and locahost errors related to the Timebase components

**[Collector (Target Historian) Configuration](https://docs.timebase.flow-software.com/knowledge-base/docker-network-settings#collector-network-config)**

[**Install 'ping'**](https://docs.timebase.flow-software.com/knowledge-base/docker-network-settings#install-ping)

[**Explorer Configuration**](https://docs.timebase.flow-software.com/knowledge-base/docker-network-settings#explorer-network-config)

[**Additional Configuration (Docker Desktop)**](https://docs.timebase.flow-software.com/knowledge-base/docker-network-settings#additional-network-config)

[**Mac ARM-based Configuration (Docker Desktop)**](https://docs.timebase.flow-software.com/knowledge-base/docker-network-settings#mac-arm-based)

---

You may encounter logs related to `localhost` or Network configurations that state a "Connection refused." If so, you will likely need to configure the network settings within the Timebase Volume files on Docker Desktop in order to historize, collect and/or visualize data.

("Connection refused" screenshot)![](https://docs.timebase.flow-software.com/hs-fs/hubfs/Connection-Refused-Collector-png.png?width=688&height=111&name=Connection-Refused-Collector-png.png)

### Collector (Target Historian) Configuration

On the Collector Config page in your web browser, select the pencil icon for the desired Target Historian. If you have more than one Target Historian, you will need to repeat these steps, if the current hostname is `localhost`. Change `localhost` to `historian`.

![](https://docs.timebase.flow-software.com/hs-fs/hubfs/image-png-Jul-10-2025-04-02-13-9021-PM.png?width=688&height=459&name=image-png-Jul-10-2025-04-02-13-9021-PM.png)

Save the changes:

![](https://docs.timebase.flow-software.com/hs-fs/hubfs/image-png-Jul-10-2025-04-01-05-6859-PM.png?width=688&height=459&name=image-png-Jul-10-2025-04-01-05-6859-PM.png)

### Install ping

If you haven't configured your container(s) to execute a `ping` command, now is a good time to do so. We will use the Explorer container for the example.

We recommend installing ping in all Timebase containers, as this is a convenient way to check if the various containers are communicating with each other.

Within a Timebase container, in the "Exec" tab (see the following screenshot), execute the following commands individually:

`apt-get update -y`

`apt-get install -y iputils-ping`

then, execute `ping historian` as a test. You should received some packet information, if installed successfully:

![](https://docs.timebase.flow-software.com/hs-fs/hubfs/image-png-Jul-10-2025-04-25-59-4166-PM.png?width=688&height=414&name=image-png-Jul-10-2025-04-25-59-4166-PM.png)

**NOTE:** can do so for each existing container to allow the `ping` command as it relates to Timebase Docker Containers and the respective names of the within the YAML file.

Restart the Docker services unless you are also using the Explorer component in your architecture. If so, continue with the Explorer Configuration below to make your datasets available from the Explorer browser page as well.

### Explorer Configuration

If you cannot see the desired datasets from the browser in your Explorer component, it is possible additional network configuration is necessary.

![](https://docs.timebase.flow-software.com/hs-fs/hubfs/No-Data-To-Show-Explorer-png.png?width=688&height=387&name=No-Data-To-Show-Explorer-png.png)

You will need to follow the previous steps (if you haven't already done so) and then go to the Docker Desktop file locations for Explorer Volume to resolve this issue.

In Docker Desktop, go to `config/sources.config` within in your Explorer Volume. You will right click the `sources.config` file to edit.

![](https://docs.timebase.flow-software.com/hs-fs/hubfs/image-png-Jul-10-2025-04-33-25-7485-PM.png?width=688&height=465&name=image-png-Jul-10-2025-04-33-25-7485-PM.png)

Edit the line containing `"Host": " ",` which is  `"Host": "localhost",` at default. If you are using Pulse and you have configured HTTPS, it is an update to similar "Host" information, but the changes will be within the "Auth" object of the JSON file. Then, SAVE the changes to the file and RESTART your containers.

The datasets should now be available from the Explorer browser page:

![](https://docs.timebase.flow-software.com/hs-fs/hubfs/Explorer-After-Docker-Restart-png-1.png?width=688&height=387&name=Explorer-After-Docker-Restart-png-1.png)

NOTE: By default, explorer files for network configuration will be located at:

**config/sources.config**

### Additional Configuration (Docker Desktop)

If you are using Docker on Windows or Linux and are having an issue with localhost, it may be helpful to update you Docker instance and utilize the "Enable host networking" feature, which was added in a recent Docker update. You can find this configuiration in the Settings when go to the Resource page and Network settings. You will need to Apply & restart Docker save the changes using the blue icon on the bottom right (see screenshot):

![](https://docs.timebase.flow-software.com/hs-fs/hubfs/Additional-Network-Config-png.png?width=688&height=387&name=Additional-Network-Config-png.png)

### Mac ARM-based Configuration (Docker Desktop)

If the aformentioned steps do not work and you are using a Mac ARM-based operating system, try using your IP address instead of `historian` .

![](https://docs.timebase.flow-software.com/hs-fs/hubfs/image-png-Jul-10-2025-04-48-36-2475-PM.png?width=688&height=465&name=image-png-Jul-10-2025-04-48-36-2475-PM.png)

---

### Support Assistance

Struggling? We are here to help and will support you. Please log your ticket and we will respond via email.

**[Submit your ticket.](https://timebase.flow-software.com/en/knowledge-base/kb-tickets/new)**

- [Software Releases](https://docs.timebase.flow-software.com/knowledge-base/software-releases?hsLang=en)
- [Timebase Quick Start](https://docs.timebase.flow-software.com/knowledge-base/timebase-quick-start?hsLang=en#main-content)

    - [Start Here!](https://docs.timebase.flow-software.com/knowledge-base/timebase-quick-start?hsLang=en#start-here)
    - [System Requirements](https://docs.timebase.flow-software.com/knowledge-base/timebase-quick-start?hsLang=en#system-requirements)
    - [Advanced Topics](https://docs.timebase.flow-software.com/knowledge-base/timebase-quick-start?hsLang=en#advanced-topics)
- [Timebase Historian](https://docs.timebase.flow-software.com/knowledge-base/timebase-historian?hsLang=en)
- [Timebase Data Collectors](https://docs.timebase.flow-software.com/knowledge-base/timebase-data-collectors?hsLang=en)
- [Timebase Explorer](https://docs.timebase.flow-software.com/knowledge-base/timebase-explorer?hsLang=en)
- [Timebase Pulse](https://docs.timebase.flow-software.com/knowledge-base/timebase-pulse?hsLang=en)
- [Windows Services Starter](https://docs.timebase.flow-software.com/knowledge-base/windows-services-starter?hsLang=en)

Copyright © 2025, Flow Software