HOWTO: Deploying Streamlit app to AWS Elastic Beanstalk (no containers)

Hello Folks,

So I decided to put up a repo that a standard template on deploying a Streamlit app to AWS Elastic Beanstalk, without containers. For me personally I like to dev, deploy and iterate quickly, similar to how I would on my laptop. Waiting for containers to upload is annoying to me, especially when traveling. So after repeating this process several times deploying several streamlit apps (and forgetting how to), I decided I probably should just make a standard repo that people could copy pasta from into their own. Maybe ill write a quick blog post later on details.

Biggest take away:

  • Include the .ebextensions/ folder. This is needed to configure nginx as proxy and for the WSGIPath to know what file and function to execute in your app
  • Procfile - needed to actually run your streamlit app as a web worker
  • Set PORT environment variable in AWS Elastic Beanstalk configuration to 8501

Here is the repo GitHub - jwalker/ip-info-checker: I created this app as a template to use for deploying Streamlit apps to AWS Elastic Beanstalk..

Hope you find it helpful. You only need to follow the AWS Elastic beanstalk docs to upload a zip of the project (or yours) with the aforementioned files above via AWS Console or the command line. Safer to go the AWS console route if you arent comfortable with the cli and a few custom configurations.

1 Like

@jwalker thank you for this guide, it’s exactly what I wanted as well.

However, when I am deploying my app with these steps and files, I am getting an error. I tried deploying yours as well and receive the same one. Was there any additional setting changes you had made besides setting PORT environment variable in AWS Elastic Beanstalk configuration to 8501?

It seems that the EB Engine is ignoring the Procfile:

2024/07/09 14:52:27.044597 [INFO] Executing instruction: check Procfile
2024/07/09 14:52:27.044609 [INFO] creating default Procfile…

2024/07/09 14:52:32.431365 [INFO] CommandService Response: {“status”:“SUCCESS”,“api_version”:“1.0”,“results”:[{“status”:“SUCCESS”,“msg”:“Engine execution has succeeded.”,“returncode”:0,“events”:[{“msg”:“Instance deployment successfully generated a ‘Procfile’.”,“timestamp”:1720536747044,“severity”:“INFO”},{“msg”:“Instance deployment completed successfully.”,“timestamp”:1720536752431,“severity”:“INFO”}]}]}

Here are excerpts from the web logs when I tried deploying the code:

Jul 9 14:52:32 ip-172-31-28-78 web[2064]: [2024-07-09 14:52:32 +0000] [2064] [INFO] Starting gunicorn 22.0.0
Jul 9 14:52:32 ip-172-31-28-78 web[2064]: [2024-07-09 14:52:32 +0000] [2064] [INFO] Listening at: http://127.0.0.1:8501 (2064)
Jul 9 14:52:32 ip-172-31-28-78 web[2064]: [2024-07-09 14:52:32 +0000] [2064] [INFO] Using worker: gthread
Jul 9 14:52:32 ip-172-31-28-78 web[2117]: [2024-07-09 14:52:32 +0000] [2117] [INFO] Booting worker with pid: 2117
Jul 9 14:52:32 ip-172-31-28-78 web[2117]: [2024-07-09 14:52:32 +0000] [2117] [ERROR] Exception in worker process

Jul 9 14:52:32 ip-172-31-28-78 web[2117]: ModuleNotFoundError: No module named ‘app’
Jul 9 14:52:32 ip-172-31-28-78 web[2117]: [2024-07-09 14:52:32 +0000] [2117] [INFO] Worker exiting (pid: 2117)
Jul 9 14:52:32 ip-172-31-28-78 web[2064]: [2024-07-09 14:52:32 +0000] [2064] [ERROR] Worker (pid:2117) exited with code 3
Jul 9 14:52:32 ip-172-31-28-78 web[2064]: [2024-07-09 14:52:32 +0000] [2064] [ERROR] Shutting down: Master
Jul 9 14:52:32 ip-172-31-28-78 web[2064]: [2024-07-09 14:52:32 +0000] [2064] [ERROR] Reason: Worker failed to boot.

As a follow-up, I realized that the Zip file must not have another folder within it (as is default if you download a Zip from Github instead of creating one yourself within the repo on your local machine.

@jwalker 's steps are correct and do work, just be sure that these files are in the root directory of the zip and there is not another folder:

  • app.py
  • Procfile
  • .ebextensions\
  • requirements.txt