Fixed "localhost" issue on macOS

[GasMD]

Just wanted to share how I configured on macOS to get the new api/webui images running successfully through docker. Hope this saves another Mac user some setup time in the future. I was persistently receiving an error about localhost:

Unable to bind to http://localhost:80 on the IPv6 loopback interface: 'Cannot assign requested address'

I read through another set of posts regarding setup on a Synology server and used the same configuration to get everything working.

My docker-compose.yaml (key changes are the addition of ports. Only other change from default/example file is my time zone):

version: "3.9"

services:
  p2g-api:
    container_name: p2g-api
    image: philosowaffle/peloton-to-garmin:api-latest
    environment:
      - TZ=America/New_York
    ports:
      - 8001:8080
    volumes:
      - ./api.local.json:/app/configuration.local.json
      - ./data:/app/data # recommended for saving settings across restarts
      - ./output:/app/output # optional, if you want access to the generated workout and log files
  
  p2g-webui:
    container_name: p2g-webui
    image: philosowaffle/peloton-to-garmin:webui-latest
    ports:
      - 8002:8080
    environment:
      - TZ=America/New_York
    volumes:
      - ./webui.local.json:/app/configuration.local.json
    depends_on:
      - p2g-api

My api.local.json (key addition is the change to HostUrl:

{
"Api": {
      "HostUrl": "http://*:8080"
    },
    
"Observability": {
  
      "Prometheus": {
        "Enabled": false,
        "Port": 4000
      },
  
      "Jaeger": {
        "Enabled": false,
        "AgentHost": "localhost",
        "AgentPort": 6831
      },
  
      "Serilog": {
        "Using": [ "Serilog.Sinks.Console", "Serilog.Sinks.File" ],
        "MinimumLevel": "Information",
        "WriteTo": [
          { "Name": "Console" },
          {
            "Name": "File",
            "Args": {
              "path": "./output/log.txt",
              "rollingInterval": "Day",
              "retainedFileCountLimit": 7
            }
          }
        ]
      }
    }
  }

My webui.local.json (key addition are the two HostUrl changes):

{
  
  "Api": {
      "HostUrl": "http://p2g-api:8080"
    },

  "WebUI": {
      "HostUrl": "http://*:8080"
    },
  
    "Observability": {
  
      "Prometheus": {
        "Enabled": false,
        "Port": 4000
      },
  
      "Jaeger": {
        "Enabled": false,
        "AgentHost": "localhost",
        "AgentPort": 6831
      },
  
      "Serilog": {
        "Using": [ "Serilog.Sinks.Console", "Serilog.Sinks.File" ],
        "MinimumLevel": "Information",
        "WriteTo": [
          { "Name": "Console" },
          {
            "Name": "File",
            "Args": {
              "path": "./output/log.txt",
              "rollingInterval": "Day",
              "retainedFileCountLimit": 7
            }
          }
        ]
      }
    }
  }

Once those files are in the same directory:

A simple

docker-compose up

command run in that directory should yield success. You'll be able to access the webui at http://localhost:8002/
Hope this saves someone time and effort!

[philosowaffle]

Thank you for sharing your setup! I think others will find this super helpful. These new configuration parameters for HostUrl are also now in the official documentation.

I'm keeping an eye on how many folks this is impacting, if it seems like most people are having to manually fix the HostUrl, then I'd like to update the defaults and instructions to use these alternate values so that it works "out of the box" in most cases.

[nick-stocks]

+1 spent an hour trying to figure this out before stumbling onto this post. Thanks!

[ital4024]

I also spent more than an hour trying to figure this out, it just wouldn't work. Solution above worked perfectly and immediately. For those of us that know almost nothing about docker (solution for idiots), these are the VERY simplistic steps I used on my Mac:

1. Download and install Docker Dashboard (https://docs.docker.com/desktop/install/mac-install/)
2. Use a simple text editor to create 3 files: docker-compose.yaml ; api.local.json; webui.local.json. Copy and paste each of the files that GasMD has shown above into the created file(s).
3. Put all 3 files into a single folder somewhere.
4. Open Terminal and run the following commands:
5. docker pull philosowaffle/peloton-to-garmin:api-latest
6. docker pull philosowaffle/peloton-to-garmin:webui-latest
7. Go back to the Docker Dashboard and click on the 2 created images to create and run 2 containers.
8. Go back to Terminal and change to the directory that your 3 files saved above are in and then run the following command: docker-compose.yaml
9. Open a browser and type: http://localhost:8002

That's it, it should work (at least it did for me). Thank you so much for creating this program and for solving my problem. I clearly need to learn Docker.

[philosowaffle]

Really wish I had I a mac and could test these steps myself, but even simpiler steps that should work are:

1. Download and install Docker Desktop (https://docs.docker.com/desktop/install/mac-install/)
2. Use a simple text editor to create 3 files: docker-compose.yaml ; api.local.json; webui.local.json. Copy and paste each of the files that @GasMD has shown above into the created file(s).
3. Put all 3 files into a single folder somewhere.
4. Open Terminal and navigate to the folder where you placed those three files
5. Run the following command:

docker-compose pull && docker-compose up -d

6. Open a browser and type: http://localhost:8002/

You can then use the Docker Desktop UI to kill the containers if needed. And to start them up again:

docker-compose up -d

Maybe the next person on mac who has to fight with the setup can give this a test and let me know if the above works.

[ital4024]

I can confirm that your simplified steps work perfectly on a Mac and are much better. You might want to put some version of this as part of the Wiki for those that use a Mac. In any case, thank you so much.

[philosowaffle]

The docs site has been updated with a new Quick Start section for those not familiar with Docker.

Additionally, all of the examples and example config files have been updated to be similar to those shared above which should ensure they work out of the box without people having to hunt down this thread.