How to deal with timeout issue when debugging Phoenix app

Article autor
September 9, 2025
How to deal with timeout issue when debugging Phoenix app
Elixir Newsletter
Join Elixir newsletter

Subscribe to receive Elixir news to your inbox every two weeks.

Oops! Something went wrong while submitting the form.
Elixir Newsletter
Expand your skills

Download free e-books, watch expert tech talks, and explore open-source projects. Everything you need to grow as a developer - completely free.

Table of contents

There is a common scenario: You'd like to debug your Phoenix app with break!/4 or IEx.pry/0. Everything works fine, until... Phoenix server throws a timeout error statement.

** (EXIT from #PID<0.5227.0>) shell process exited with reason: shutdown

It happens after about 60 seconds. Why?

The process has a certain amount of time to send a response. If it takes more - then the server says: "It takes too long. The process is probably suspended and in the meanwhile, the Client/user is raging on the other side. Let's kill him... (the process, not the user)".

Usually, it's a very nice, and helpful logic. But in the case of debugging it might be a real pain in the neck.

As soon, as we know the reason, we're able to find the solution. And here we are. Just set the idle_timeout option at your endpoint config. Generally at config/dev.exs, or so.

config :appname, Appname.Endpoint,
  http: [
    protocol_options: [idle_timeout: 5_000_000_000],
    ...   
  ]

Related posts

Dive deeper into this topic with these related posts

No items found.

You might also like

Discover more content from this category

Load CSS as string using JS & Webpack import prefixes

People will tell you it's an antipattern, but what if a library needs you to do this?

Skip file changes tracking in git

So, you’re changing this one file for local development purposes only. Maybe it’s config, maybe some source file, but one thing is certain - you don’t want those changes to be committed. And what’s worse, .gitignore doesn’t work.

How to process Phoenix conn after render before it is sent as a response

There are a bunch of operations you may want to perform before the rendered response in conn is sent to the client, such as minification. In this post I'll show you how to do it easily.