{"id":2988,"date":"2024-02-15T21:12:51","date_gmt":"2024-02-03T20:54:33","guid":{"rendered":""},"modified":"2025-02-02T00:46:19","modified_gmt":"2025-02-01T23:46:19","slug":"how-to-install-flask-with-nginx-and-gunicorn-on-ubuntu-22-04","status":"publish","type":"post","link":"https:\/\/netcloud24.com\/knowledgebase\/how-to-install-flask-with-nginx-and-gunicorn-on-ubuntu-22-04\/","title":{"rendered":"Linux VPS & VPS Windows Setup Guide | NetCloud24 Flask with Nginx and Gunicorn on Ubuntu 22.04"},"content":{"rendered":"

\u00a0<\/p>\n<\/p>\n

\n

\u00a0<\/h1>\n<\/header>\n
\n

Flask is a lightweight and flexible Python web framework, and it\u2019s often used with Gunicorn (a Python WSGI HTTP server) and Nginx (a high-performance web server) for production deployments. This guide will walk you through installing Flask with Nginx and Gunicorn on Ubuntu 22.04. Whether you\u2019re hosting your Flask app locally or on a , this setup provides excellent scalability and performance.<\/p>\n

\n

Step 1: Update Your System<\/h2>\n

Before starting, ensure your Ubuntu system is up to date. Run the following commands to update your package list and upgrade any existing packages:<\/p>\n

sudo apt update && sudo apt upgrade -y<\/code><\/pre>\n
Regular updates ensure that your server is secure and running smoothly, which is especially important for applications running on platforms like VPS Windows VPS Servers<\/a>.<\/p>\n<\/section>\n
\n
Step 2: Install Python, Flask, and Virtual Environment<\/h2>\n
Install Python and the necessary tools for creating a virtual environment:<\/p>\n
sudo apt install python3 python3-pip python3-venv -y<\/code><\/pre>\n
Next, create a project directory for your Flask app and navigate into it:<\/p>\n
mkdir ~\/myflaskapp\r\ncd ~\/myflaskapp<\/code><\/pre>\n
Create a Python virtual environment to keep your project dependencies isolated:<\/p>\n
python3 -m venv venv<\/code><\/pre>\n
Activate the virtual environment:<\/p>\n
source venv\/bin\/activate<\/code><\/pre>\n
Install Flask within the virtual environment:<\/p>\n
pip install Flask<\/code><\/pre>\n<\/section>\n
\n
Step 3: Create a Simple Flask Application<\/h2>\n
Create a simple Flask app by creating a new Python file:<\/p>\n
nano ~\/myflaskapp\/app.py<\/code><\/pre>\n
Add the following content to create a basic Flask app:<\/p>\n
from flask import Flask\r\napp = Flask(__name__)\r\n\r\n@app.route('\/')\r\ndef hello():\r\n    return \"Hello, World!\"\r\n\r\nif __name__ == '__main__':\r\n    app.run(host='0.0.0.0')<\/code><\/pre>\n
Save and close the file.<\/p>\n<\/section>\n
\n
Step 4: Install and Configure Gunicorn<\/h2>\n
Install Gunicorn inside your virtual environment:<\/p>\n
pip install gunicorn<\/code><\/pre>\n
Now, run Gunicorn to serve your Flask application:<\/p>\n
gunicorn --bind 0.0.0.0:8000 app:app<\/code><\/pre>\n
This will bind Gunicorn to port 8000 and run your Flask app. At this point, you can access your Flask app by navigating to http:\/\/your_server_ip:8000<\/code> in your browser.<\/p>\n<\/section>\n
\n
Step 5: Set Up Gunicorn as a Systemd Service<\/h2>\n
To run Gunicorn as a background service, create a systemd service file:<\/p>\n
sudo nano \/etc\/systemd\/system\/myflaskapp.service<\/code><\/pre>\n
Add the following content, replacing \/home\/your_username<\/code> with the correct path to your Flask app:<\/p>\n
[Unit]\r\nDescription=Gunicorn instance to serve Flask app\r\nAfter=network.target\r\n\r\n[Service]\r\nUser=your_username\r\nGroup=www-data\r\nWorkingDirectory=\/home\/your_username\/myflaskapp\r\nEnvironment=\"PATH=\/home\/your_username\/myflaskapp\/venv\/bin\"\r\nExecStart=\/home\/your_username\/myflaskapp\/venv\/bin\/gunicorn --workers 3 --bind unix:myflaskapp.sock -m 007 app:app\r\n\r\n[Install]\r\nWantedBy=multi-user.target<\/code><\/pre>\n
Save and close the file, then reload systemd to apply the new service:<\/p>\n
sudo systemctl daemon-reload<\/code><\/pre>\n
Start the Gunicorn service and enable it to start at boot:<\/p>\n
sudo systemctl start myflaskapp\r\nsudo systemctl enable myflaskapp<\/code><\/pre>\n<\/section>\n
\n
Step 6: Install and Configure Nginx<\/h2>\n
Install Nginx with the following command:<\/p>\n
sudo apt install nginx -y<\/code><\/pre>\n
Create an Nginx server block for your Flask app:<\/p>\n
sudo nano \/etc\/nginx\/sites-available\/myflaskapp<\/code><\/pre>\n
Add the following configuration:<\/p>\n
server {\r\n    listen 80;\r\n    server_name your_domain_or_ip;\r\n\r\n    location \/ {\r\n        proxy_pass http:\/\/unix:\/home\/your_username\/myflaskapp\/myflaskapp.sock;\r\n        proxy_set_header Host $host;\r\n        proxy_set_header X-Real-IP $remote_addr;\r\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\r\n        proxy_set_header X-Forwarded-Proto $scheme;\r\n    }\r\n\r\n    location \/static\/ {\r\n        alias \/home\/your_username\/myflaskapp\/static\/;\r\n    }\r\n}<\/code><\/pre>\n
Enable the Nginx configuration and restart the service:<\/p>\n
sudo ln -s \/etc\/nginx\/sites-available\/myflaskapp \/etc\/nginx\/sites-enabled\/\r\nsudo systemctl restart nginx<\/code><\/pre>\n<\/section>\n
\n
Step 7: Obtain an SSL Certificate with Let’s Encrypt (Optional)<\/h2>\n
To secure your Flask app with HTTPS, you can use Let’s Encrypt to obtain a free SSL certificate. First, install Certbot:<\/p>\n
sudo apt install certbot python3-certbot-nginx -y<\/code><\/pre>\n
Then, run Certbot to obtain and configure SSL:<\/p>\n
sudo certbot --nginx -d your_domain<\/code><\/pre>\n
Follow the prompts to set up SSL. Certbot will automatically update your Nginx configuration.<\/p>\n<\/section>\n