{"id":14037,"date":"2023-01-06T08:36:23","date_gmt":"2023-01-06T08:36:23","guid":{"rendered":"http:\/\/localhost\/cloudpap\/?post_type=docs&p=14037"},"modified":"2023-02-03T05:50:11","modified_gmt":"2023-02-03T05:50:11","password":"","slug":"deploy-a-flask-app-in-cpanel","status":"publish","type":"docs","link":"https:\/\/cloudpap.com\/blog\/docs\/deploy-a-flask-app-in-cpanel\/","title":{"rendered":"How to deploy a Flask App in cPanel"},"content":{"rendered":"

Each hosting package in CloudPap\u00a0allows hosting of Python Applications. Flask and Django top the Python frameworks people prefer. In this guide we will learn how to deploy a Flask Application in cPanel.<\/p>\n

Prerequisites<\/strong><\/h2>\n

-Flask App already created on your computer using Python 3<\/p>\n

-Flask App has a requirements.txt file ready. This can be created on your localhost by running the command below in the directory where your flask files reside:<\/p>\n

$ pip3 freeze >> requirements.txt<\/p>\n

A.\u00a0Create a Python App in cPanel<\/strong><\/h2>\n

1.\u00a0Login<\/strong>\u00a0to cPanel<\/p>\n

2. Navigate to\u00a0Setup Python App<\/strong>\u00a0icon and click it.<\/p>\n

\"\"<\/figure>\n

3. Click\u00a0Create Application<\/strong><\/p>\n

\"\"<\/figure>\n

4. Fill in the form as follows then click\u00a0Create<\/strong><\/p>\n

Python version\u00a0<\/strong>\u2013 Select the Python version you need. We will use Python 3.8. If unsure, use the latest Python3 available.<\/p>\n

Application root<\/strong>\u00a0\u2013 This is the folder where you will put your website files e.g static and template folders etc<\/p>\n

Application URL<\/strong>\u00a0\u2013 This is the link people will use to access your application eg truehost.co.ke, truehost.co.ke\/blog, portal.truehost.co.ke etc.<\/p>\n

Application startup file\u00a0<\/strong>\u2013 This is the file that should be run to load your application eg app.py, main.py etc<\/p>\n

Application Entry point<\/strong>\u00a0\u2013 This is the function that should be run to display your site. Its contained in your startup file under route(\u201c\/\u201d)<\/p>\n

Passenger log file<\/strong>\u00a0\u2013 This is the file where errors will be logged. Helps with debugging and fixing errors<\/p>\n

\"\"<\/figure>\n

5. Stop the Application.<\/strong>\u00a0You will restart it after upload files.<\/p>\n

B.\u00a0Upload your application files<\/strong><\/h2>\n

Once you create an application as described above, a\u00a0virtualenv<\/strong><\/em>\u00a0will be created. A folder called\u00a0appfiles<\/strong>\u00a0will be created as well under\u00a0File Manager.<\/strong><\/p>\n

1. In cPanel, go to\u00a0File Manager<\/strong><\/p>\n

2. Access\u00a0appfiles<\/strong>\u00a0folder<\/p>\n

3. On your computer and create a zip file containing your template folder, static folder, requirements.txt and python files.<\/p>\n

4. Click\u00a0Upload<\/strong>\u00a0under\u00a0appfiles<\/strong>\u00a0folder and upload your zip files.<\/p>\n

5. Once uploaded, extract the files<\/p>\n

C.\u00a0Update\u00a0<\/strong>main.py<\/strong><\/em>\u00a0and\u00a0<\/strong>passenger_wsgi.py\u00a0<\/strong><\/em>files<\/strong><\/h2>\n

1. Open the main.py file and add the line below under app = Flask(__name__) line<\/p>\n

application = app<\/strong><\/em><\/p>\n

2. Open the passenger_wsgi.py and delete the content in it then add the line below and\u00a0Save<\/strong><\/p>\n

from main import application<\/em><\/strong><\/p>\n

D. Import modules in requirements.txt file<\/strong><\/h2>\n

1. In cPanel, got to\u00a0Setup Py<\/strong>t<\/strong>hon App<\/strong>.<\/p>\n

2. Under\u00a0Configuration files<\/strong>, type in requirements.txt and click\u00a0Add<\/strong><\/p>\n

3. Click\u00a0Run Pip Install<\/strong><\/p>\n

\"\"<\/figure>\n

4. Once the modules are installed, you can\u00a0Start the Application<\/strong><\/p>\n

\"\"<\/figure>\n

Hurray! Your app is now live.<\/p>\n

Troubleshooting<\/h2>\n
    \n
  1. We\u2019re sorry, but something went wrong.
    \nYou may see the page below when trying to run your application<\/li>\n<\/ol>\n
    \"\"<\/figure>\n

    In cPanel, python, ruby and nodejs applications run via Phusion Passenger. The page above indicates you app run into an error and could not be loaded, but it does not show the exact error message as the app is in production. Your app users don\u2019t need to see the python error.<\/p>\n

    As such, to fix, you need to check the Apache logs (Check Errors icon under Metrics) and passenger log file you configured while creating the application in Step A above. Some of the causes of the error above and their solutions are:<\/p>\n

    \n\n\n\n\n\n\n
    Issue<\/strong><\/td>\nSolution<\/strong><\/td>\n<\/tr>\n
    Incorrect file\/folder permissions<\/td>\nAll files should be 0644 and folders 0755 permissions<\/td>\n<\/tr>\n
    Mod Security in cPanel<\/td>\nTurn off Mod Security in cPanel<\/a><\/td>\n<\/tr>\n
    Incorrect database configuration<\/td>\nIf your site runs on a database, supply the correct connection details<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n

    2. Incomplete response received from application<\/p>\n

    One cause of this error is that, your passenger_wsgi.py file was over writen on restarting the application. Hence the content we put in there was removed. The solution is just to paste back the line below then restart the app.<\/p>\n

    from main import application<\/p>\n","protected":false},"excerpt":{"rendered":"

    Each hosting package in CloudPap\u00a0allows hosting of Python Applications. Flask and Django top the Python frameworks people prefer. In this guide we will learn how to deploy a Flask Application in cPanel. Prerequisites -Flask App already created on your computer using Python 3 -Flask App has a requirements.txt file ready. This can be created on…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"doc_category":[129],"doc_tag":[],"class_list":["post-14037","docs","type-docs","status-publish","hentry","doc_category-hosting"],"year_month":"2026-04","word_count":613,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"Cloud Pap","author_nicename":"cloudpapadmin2023","author_url":"https:\/\/cloudpap.com\/blog\/author\/cloudpapadmin2023\/"},"doc_category_info":[{"term_name":"Hosting","term_url":"https:\/\/cloudpap.com\/blog\/docs-category\/hosting\/"}],"doc_tag_info":[],"_links":{"self":[{"href":"https:\/\/cloudpap.com\/blog\/wp-json\/wp\/v2\/docs\/14037","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cloudpap.com\/blog\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/cloudpap.com\/blog\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/cloudpap.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/cloudpap.com\/blog\/wp-json\/wp\/v2\/comments?post=14037"}],"version-history":[{"count":0,"href":"https:\/\/cloudpap.com\/blog\/wp-json\/wp\/v2\/docs\/14037\/revisions"}],"wp:attachment":[{"href":"https:\/\/cloudpap.com\/blog\/wp-json\/wp\/v2\/media?parent=14037"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/cloudpap.com\/blog\/wp-json\/wp\/v2\/doc_category?post=14037"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/cloudpap.com\/blog\/wp-json\/wp\/v2\/doc_tag?post=14037"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}