# Forge Tunnel - Error checking docker image

**URL:** <https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490>\
**Category:** Forge\
**Tags:** forge-tunnel, docker\
**Created:** [February 23, 2021, 3:46pm UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490 "2021-02-23T15:46:13Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![LarkinYoung](https://avatars.discourse-cdn.com/v4/letter/l/958977/32.png) [@LarkinYoung](https://community.developer.atlassian.com/u/LarkinYoung)\
**Post date:** [February 23, 2021, 3:46pm UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/1 "2021-02-23T15:46:13Z")

</div>

When I try to run the forge tunnel command I am getting an exception being thrown. This is with the latest forge libraries.

 ![39](https://global.discourse-cdn.com/atlassiandeveloper/original/3X/8/4/84fafc13c24c510699121fd84e86c9a8da8c3786.png)

---

<div class="post-metadata">

**Author:** ![rmassaioli](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/rmassaioli/32/35834_2.png) [@rmassaioli](https://community.developer.atlassian.com/u/rmassaioli)\
**Post date:** [February 24, 2021, 9:30am UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/2 "2021-02-24T09:30:04Z")

</div>

Do you have Docker installed?

---

<div class="post-metadata">

**Author:** ![LarkinYoung](https://avatars.discourse-cdn.com/v4/letter/l/958977/32.png) [@LarkinYoung](https://community.developer.atlassian.com/u/LarkinYoung)\
**Post date:** [February 24, 2021, 1:40pm UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/3 "2021-02-24T13:40:12Z")

</div>

You know, I thought I did, but it turns out I didn’t (forgot that I had just switched laptops) 🤦‍♂️

So, I installed Docker but now I get this error when running `forge tunnel`

 ![57](https://global.discourse-cdn.com/atlassiandeveloper/original/3X/f/8/f89af54a6aaf58482e3d6ccdcc6b7d6c8c78f262.png)

---

<div class="post-metadata">

**Author:** ![bentley](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/bentley/32/36116_2.png) [@bentley](https://community.developer.atlassian.com/u/bentley)\
**Post date:** [February 24, 2021, 1:41pm UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/4 "2021-02-24T13:41:31Z")

</div>

Is Docker _running_? 😅

Ran into something similar yesterday and realized I wasn’t actually running Docker…

---

<div class="post-metadata">

**Author:** ![LarkinYoung](https://avatars.discourse-cdn.com/v4/letter/l/958977/32.png) [@LarkinYoung](https://community.developer.atlassian.com/u/LarkinYoung)\
**Post date:** [February 24, 2021, 2:28pm UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/5 "2021-02-24T14:28:58Z")

</div>

Well that’s another facepalm moment for me. That fixed it. Thanks!

---

<div class="post-metadata">

**Author:** ![ThomasBerger](https://avatars.discourse-cdn.com/v4/letter/t/b5a626/32.png) [@ThomasBerger](https://community.developer.atlassian.com/u/ThomasBerger)\
**Post date:** [March 9, 2021, 8:17pm UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/6 "2021-03-09T20:17:10Z")

</div>

FYI, this happens even when Docker is installed and running.  
I found that in the Docker app, I was no longer logged in with my “Docker ID”. Only after re-authenticating in Docker I was able to pull the forge-tunnel-docker container and use ‘forge tunnel’ successfully.

---

<div class="post-metadata">

**Author:** ![FarukUNAL](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/farukunal/32/44592_2.png) [@FarukUNAL](https://community.developer.atlassian.com/u/FarukUNAL)\
**Post date:** [March 6, 2022, 4:57pm UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/7 "2022-03-06T16:57:01Z")

</div>

I have the same problem, even with Docker running. Do u know any alternative solutions?

```auto
service docker status
● docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since Sun 2022-03-06 16:20:37 +03; 3h 35min ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 1903 (dockerd)
      Tasks: 20
     Memory: 745.0M
     CGroup: /system.slice/docker.service
             └─1903 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

```

```auto
forge tunnel
Tunnel redirects requests you make to your local machine. This occurs for any Atlassian site where your app is installed in the development environment. You will not see requests from other users.
Press Ctrl+C to cancel.

Checking Docker image... failed   
Cannot pull the tunnel image.

```

---

<div class="post-metadata">

**Author:** ![FarukUNAL](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/farukunal/32/44592_2.png) [@FarukUNAL](https://community.developer.atlassian.com/u/FarukUNAL)\
**Post date:** [March 9, 2022, 6:45pm UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/8 "2022-03-09T18:45:30Z")

</div>

It’s solved! Just tried a few days later. It might be related to my network/ISS.

---

<div class="post-metadata">

**Author:** ![IanStuardoHenriquez](https://avatars.discourse-cdn.com/v4/letter/i/6f9a4e/32.png) [@IanStuardoHenriquez](https://community.developer.atlassian.com/u/IanStuardoHenriquez)\
**Post date:** [October 23, 2022, 6:21am UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/9 "2022-10-23T06:21:01Z")

</div>

For this Item, I exec the comand with sudo `sudo forge tunnel` with docker install in PC

---

<div class="post-metadata">

**Author:** ![kacper\_nowak](https://avatars.discourse-cdn.com/v4/letter/k/7bcc69/32.png) [@kacper\_nowak](https://community.developer.atlassian.com/u/kacper_nowak)\
**Post date:** [June 28, 2023, 8:46am UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/10 "2023-06-28T08:46:00Z")

</div>

I have a lot of problems with ipv4 ipv6 topic. I have tried to turn on or off ipv6, but it seams that with wsl2 to make forge work ipv6 must be enabled on all interfaces, even your ethernet or wifi interface in host machine.

---

<div class="post-metadata">

**Author:** ![FelipeRodriguez](https://avatars.discourse-cdn.com/v4/letter/f/f1d935/32.png) [@FelipeRodriguez](https://community.developer.atlassian.com/u/FelipeRodriguez)\
**Post date:** [July 18, 2023, 2:56pm UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/11 "2023-07-18T14:56:46Z")

</div>

This works for me ! Thanks, two days with this issue haha

---

<div class="post-metadata">

**Author:** ![rajurajvijay619](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/rajurajvijay619/32/49215_2.png) [@rajurajvijay619](https://community.developer.atlassian.com/u/rajurajvijay619)\
**Post date:** [October 22, 2023, 7:19pm UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/12 "2023-10-22T19:19:13Z")

</div>

I have Docker installed and running.  
I have also logged into docker. I still get the same error.  
Though docker shows the forge tunnel image and the container.

```bash

% docker login     
Authenticating with existing credentials...
Login Succeeded

% forge tunnel
Tunnel redirects requests you make to your local machine. This occurs for any Atlassian site where your app is installed in the specific development environment. You will not see requests from other users.
Press Ctrl+C to cancel.

Checking Docker image... failed   
Cannot pull the tunnel image.

Checking Docker image... failed   
Cannot pull the tunnel image.

Tunnel uses an anonymous ngrok account, which has a time limit of 2 hours. After that time, you'll need to restart your tunnel.

=== Running forge lint...
No issues found.

=== Bundling code...
✔ Functions bundled.

=== Snapshotting functions...
No log output.

Listening for requests...

% docker ps -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
22c4e026f255 atlassian/forge-tunnel:latest "/tini -g -- /bin/ba…" About a minute ago Up About a minute 0.0.0.0:8000->8000/tcp forge-tunnel-docker-95592

% docker images | grep forge
atlassian/forge-tunnel latest 677483b548a0 5 days ago 590MB

% forge --version
6.20.0

```

---

<div class="post-metadata">

**Author:** ![NicolasGrunberg](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/nicolasgrunberg/32/46054_2.png) [@NicolasGrunberg](https://community.developer.atlassian.com/u/NicolasGrunberg)\
**Post date:** [October 22, 2023, 11:03pm UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/13 "2023-10-22T23:03:11Z")

</div>

> [@rajurajvijay619](#):
>
> `Cannot pull the tunnel image.`

Hello @rajurajvijay619 ,

This might be a side effect related to the release of a new Docker version. This has been reported in ["Cannot pull the tunnel image"](https://community.developer.atlassian.com/t/cannot-pull-the-tunnel-image/71995) . A fix is in progress (see [[FRGE-1262] - Ecosystem Jira](https://ecosystem.atlassian.net/browse/FRGE-1262))

As a workaround, could you please try to do the following?  
Set `DOCKER_CLI_HINTS=false` in your shell environment to suppress this message, or uncheck the “Show CLI Hints” option in the Docker Desktop settings.

Best regards,  
Nicolas

---

<div class="post-metadata">

**Author:** ![rajurajvijay619](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/rajurajvijay619/32/49215_2.png) [@rajurajvijay619](https://community.developer.atlassian.com/u/rajurajvijay619)\
**Post date:** [October 23, 2023, 6:19am UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/14 "2023-10-23T06:19:01Z")

</div>

Thank you @NicolasGrunberg , I don’t see the misleading message now.

```bash
% export DOCKER_CLI_HINTS=false

% forge tunnel            
Tunnel redirects requests you make to your local machine. This occurs for any Atlassian site where your app is installed in the specific development environment. You will not see requests from other users.
Press Ctrl+C to cancel.

Checking Docker image... 100%   
Your Docker image is up to date.
Tunnel uses an anonymous ngrok account, which has a time limit of 2 hours. After that time, you'll need to restart your tunnel.

=== Running forge lint...
No issues found.

=== Bundling code...
✔ Functions bundled.

=== Snapshotting functions...
No log output.

Listening for requests...

```

NOTE: We need to export the variable, not merely set it.

```bash
% DOCKER_CLI_HINTS=false

% forge tunnel       
Tunnel redirects requests you make to your local machine. This occurs for any Atlassian site where your app is installed in the specific development environment. You will not see requests from other users.
Press Ctrl+C to cancel.

Checking Docker image... failed   
Cannot pull the tunnel image.

Checking Docker image... failed   
Cannot pull the tunnel image.

```

---

<div class="post-metadata">

**Author:** ![ccosmin](https://avatars.discourse-cdn.com/v4/letter/c/85f322/32.png) [@ccosmin](https://community.developer.atlassian.com/u/ccosmin)\
**Post date:** [February 4, 2024, 9:40pm UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/15 "2024-02-04T21:40:42Z")

</div>

I had the same issue: `Cannot pull the tunnel image.`  
However, this doesn’t seem to be the real problem why `forge tunnel` stopped working.  
I had Docker running fine and the latest image was correctly pulled.

What happened is that ngrok was not correctly setup. Follow closely the first paragraph here: [https://developer.atlassian.com/platform/forge/tunneling](https://developer.atlassian.com/platform/forge/tunneling), namely setting up the correct credentials for ngrok.

Of course, `forge` could better report the actual error.

---

<div class="post-metadata">

**Author:** ![DSmith](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/dsmith/32/49698_2.png) [@DSmith](https://community.developer.atlassian.com/u/DSmith)\
**Post date:** [March 12, 2024, 4:09pm UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/16 "2024-03-12T16:09:35Z")

</div>

@ccosmin saved me

---

<div class="post-metadata">

**Author:** ![gilmegidish](https://avatars.discourse-cdn.com/v4/letter/g/d07c76/32.png) [@gilmegidish](https://community.developer.atlassian.com/u/gilmegidish)\
**Post date:** [March 22, 2024, 2:10pm UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/17 "2024-03-22T14:10:22Z")

</div>

I’ve had the same issue, upgraded forge, upgraded docker, fixed the cli\_hints, nothing helped.

Eventually found out (by creating a new a project) that a comment in manifest.yml just exits “forge tunnel” without any explanation.

I guess I should have tried `forge lint` manually to debug `forge tunnel`. I hope this saves somebody’s hour in the future 🙂

---

<div class="post-metadata">

**Author:** ![SateeshB](https://avatars.discourse-cdn.com/v4/letter/s/9d8465/32.png) [@SateeshB](https://community.developer.atlassian.com/u/SateeshB)\
**Post date:** [April 8, 2024, 12:21pm UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/18 "2024-04-08T12:21:11Z")

</div>

> [@NicolasGrunberg](#):
>
> DOCKER\_CLI\_HINTS=false

This solved the issue.

---

<div class="post-metadata">

**Author:** ![ibuchanan](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/ibuchanan/32/35815_2.png) [@ibuchanan](https://community.developer.atlassian.com/u/ibuchanan)\
**Post date:** [April 8, 2024, 12:30pm UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/19 "2024-04-08T12:30:28Z")

</div>

Hey community,

Thanks for posting about your problems & solutions on this thread. I’m going to lock this thread because the symptom has multiple possible underlying problems with multiple possible solutions.

For people who stumble across this thread in future, please know the following error message has multiple meanings:

```plaintext
Checking Docker image... failed  
Cannot pull the tunnel image.

```

Please try the solutions mentioned here, especially `DOCKER_CLI_HINTS=false`. However, if that’s not enough to solve the problem, please create a new topic. Problems related to this error message will need additional details such as:

- Forge CLI version: `forge --version`
- Verbose output: `forge tunnel --verbose`
- Docker version: `docker --version`
- Any network details, such as intermediate web proxies between your host and Atlassian.

---

<div class="post-metadata">

**Author:** ![ibuchanan](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/ibuchanan/32/35815_2.png) [@ibuchanan](https://community.developer.atlassian.com/u/ibuchanan)\
**Post date:** [April 8, 2024, 12:30pm UTC](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/20 "2024-04-08T12:30:31Z")

</div>


