To deploy a Chalk’it application in Ploomber Cloud you need:

  • A Dockerfile

  • A Chalk’it projet definition JSON file renamed to application.xprjson


You just need to use this template Dockerfile:

FROM python:3.11

# assume your application is named application.xprjson
COPY application.xprjson application.xprjson

# install py-chalk-it and gunicorn
RUN pip install py-chalk-it gunicorn

# this configuration is needed for your app to work, do not change it
ENTRYPOINT ["gunicorn", "chlkt.render:app", "run", "--bind", ""]

Testing locally#

To test your app, you can use docker locally:

# build the docker image
docker build . -t application

# run it
docker run -p 5000:80 application

Now, open to see your app.


Once you have all your files, create a zip file.

To deploy a Chalk’it app from the deployment menu, follow these instructions: