Debugging Docker build errors#

Installing PyTorch#

If you’re deploying Docker apps using a free account, your build might fail if it takes too many resources. To fix it, you can install the CPU-only version of PyTorch. Add the following to your Dockerfile before any packages that have PyTorch as a dependency

# install the cpu-only torch (or any other torch-related packages)
# you might modify it to install another version
RUN pip install torch==2.1.1 torchvision==0.16.1 --index-url

# any packages that depend on pytorch must be installed after the previous RUN command

Installing OpenCV#

If you’re using OpenCV and your application gets stuck during deployment, ensure you check the Webservice logs, if you’re using a base image that doesn’t have all dependencies required by OpenCV, you might run into issues like this one: cannot open shared object file

If that’s the case, run the following before installing OpenCV, note that this requires your base image to use apt as its package manager. We recommend you using the python:3.11 base image.

RUN apt-get update && apt-get install ffmpeg libsm6 libxext6  -y

Installing geopandas/fiona/GDAL#

If you want to deploy an application that uses geopandas, you can simply add it to your requirements.txt file:


This will work as long as you’re deploying any of the officially supported frameworks or if you’re using the Docker deployment option and using the python:3.11 base image. Here’s a sample Voilà app.

geopandas can be tricky to install because it depends on fiona, which depends on GDAL, fortunately, fiona bundles GDAL which simplifies installation, this allows geopandas to work by adding it to the requirements.txt file.

The caveat of this method is that the bundled GDAL is not fully-featured and omits many GDAL’s optional drivers. If you require a full-fledged GDAL version on your application, you can do it by using the Docker deployment option and installing GDAL in your Docker image. Here’s a sample app.