{"id":3343,"date":"2025-04-25T07:02:22","date_gmt":"2025-04-25T07:02:22","guid":{"rendered":"https:\/\/mailitics.com\/index.php\/2025\/04\/25\/aws-deploying-a-fastapi-app-on-ec2-in-minutes\/"},"modified":"2025-04-25T07:02:22","modified_gmt":"2025-04-25T07:02:22","slug":"aws-deploying-a-fastapi-app-on-ec2-in-minutes","status":"publish","type":"post","link":"https:\/\/mailitics.com\/index.php\/2025\/04\/25\/aws-deploying-a-fastapi-app-on-ec2-in-minutes\/","title":{"rendered":"AWS:\u00a0Deploying a FastAPI App on EC2 in Minutes"},"content":{"rendered":"

AWS:\u00a0Deploying a FastAPI App on EC2 in Minutes
\n \t

\n
<\/BR>
\n
\n \t

\n
<\/BR><\/p>\n

\n

Introduction<\/mdspan><\/h2>\n

AWS<\/a> is a popular cloud provider that enables the deployment and scaling of large applications. Mastering at least one cloud platform is an essential skill for software engineers and data scientists. Running an application locally is not enough to make it usable in production \u2014 it must be deployed on a server to become accessible to end users.<\/p>\n

In this tutorial, we will walk through an example of deploying a FastAPI application. While the example focuses on core EC2 networking concepts, the principles are broadly applicable to other types of applications as well.<\/p>\n

\n

Please note that this tutorial does not cover best practices for AWS usage. Instead, the goal is to give readers a hands-on introduction to application deployment using EC2 instances.<\/p>\n<\/blockquote>\n

# 01. Instance creation<\/h2>\n

Navigate to the Ec2<\/a> dashboard in the AWS service menu and choose to create a new instance. This will open a page where we can define instance parameters.<\/p>\n

\"\"<\/figure>\n

Select the corresponding instance type. In this tutorial, we will launch a very simple server with minimal technical requirements, so\u00a0t3.nano<\/em>\u00a0should be sufficient for our needs.<\/p>\n

\"\"<\/figure>\n

For its containers, AWS uses SSH authentication. When creating a new instance, it is necessary to create a new key pair that will allow us to log in from the local machine using the SSH protocol. Click on\u00a0Create new key pair<\/em><\/strong>.<\/p>\n

\"\"<\/figure>\n

Assign a name to the new key. We will not dive into the possible options here, so we will choose RSA as the key pair type and .pem as the private key file format.<\/p>\n

\"\"<\/figure>\n

To save time, in our demonstration application we will not worry about security. For the network settings, tick all the checkboxes corresponding to SSH, HTTP, and HTTPS traffic.<\/p>\n

\"\"<\/figure>\n

Great! By clicking\u00a0Launch instance<\/strong>, AWS will create a new instance.<\/p>\n

\"\"<\/figure>\n

After the instance is created, a\u00a0.pem<\/em>\u00a0file will be downloaded to your local machine. This file contains the private key that allows SSH authentication. As a good practice, store this file in a safe location because AWS does not provide a way to recover it if it is lost.<\/p>\n

By opening the EC2 dashboard, you will notice that the created instance has an associated IP address. This IP is shown under the label\u00a0\u201cPublic IPv4 address\u201d<\/em>. For example, in the image below, it is\u00a0\u201c16.16.202.153\u201d<\/em>. Once we deploy our application, it will be accessible from a browser using this IP address.<\/p>\n

\"\"<\/figure>\n

# 02. SSH connection<\/h2>\n

AWS offers several ways to perform authentication. In our case, we will use the SSH mechanism.<\/p>\n

In the instance menu, click\u00a0Connect<\/em><\/strong>\u00a0and select\u00a0SSH client<\/em><\/strong>\u00a0from the top bar.<\/p>\n

\"\"<\/figure>\n

Open the local terminal and, using the screenshot above as reference, copy and execute command #3 (chmod 400 \"<key_name>.pem\"<\/code>) along with the command shown below the\u00a0\u201cExample\u201d<\/em>\u00a0label. Make sure your current terminal directory matches the location where the\u00a0.pem<\/em>\u00a0key was downloaded in the previous step.<\/p>\n

During the SSH connection, the terminal might prompt whether to proceed. If it does, type\u00a0\u201cyes\u201d<\/em>.<\/p>\n

\n

At this point, we are successfully connected from the local terminal to the EC2 instance. Any commands entered into the terminal will now be executed directly in the EC2 container.<\/p>\n<\/blockquote>\n

# 03. Environment configuration<\/h2>\n

After connecting to the instance from the local terminal, the next step is to update the package manager and install Python along with Nginx.<\/p>\n

sudo apt-get update\nsudo apt install -y python3-pip nginx<\/code><\/pre>\n
To redirect traffic to our application, we need to create an Nginx configuration file. This file should be placed in the directory\u00a0\/etc\/nginx\/sites-enabled\/<\/code>\u00a0and can have any custom name. We will add the following configuration to it:<\/p>\n
server {\n  listen 80;\n  server_name <Public_IP_Address>;\n  location \/ {\n    proxy_pass http:\/\/127.0.0.1:8000;\n  }\n}<\/code><\/pre>\n
Basically, we are specifying that any external request sent to the EC2 instance\u2019s IP address on the default port 80 should be redirected via a proxy to the application running inside the EC2 container at the address\u00a0http:\/\/127.0.0.1:8000<\/code>. As a reminder, this is the default HTTP address and port assigned by FastAPI.<\/p>\n
To apply these changes, we need to restart Nginx:<\/p>\n
sudo service nginx restart<\/code><\/pre>\n
If we have a FastAPI server that we would like to launch, the simplest way would be to publish it on GitHub and then clone the repository onto the EC2 instance.<\/p>\n
git clone <GitHub_URL> <directory>\ncd <directory><\/code><\/pre>\n
Create and activate a virtual environment:<\/p>\n
python3 -m venv venv\nsource venv\/bin\/activate<\/code><\/pre>\n
Install the necessary Python requirements (assuming that the cloned repository contains a\u00a0requirements.txt<\/em>\u00a0file):<\/p>\n
pip3 install -r requirements.txt<\/code><\/pre>\n
Run the server:<\/p>\n
python3 -m uvicorn <server_filename>:app<\/code><\/pre>\n
Open the browser and enter the IP address of the instance.<\/p>\n
Make sure to use the HTTP (not HTTPS) protocol. For example:\u00a0<a href=\"http:\/\/16.16.202.153\/\" rel=\"noreferrer noopener\" target=\"_blank\">http:\/\/16.16.202.153<\/a><\/code>. The firewall might block your connection, but you should proceed to open the web page. Add\u00a0\/docs<\/code>\u00a0after the URL to open Fast API Swagger.<\/p>\n
Exercise<\/h3>\n
If you would like to run a FastAPI example, you can create a simple repository consisting of just a\u00a0main.py<\/em>\u00a0file and a\u00a0requirements.txt<\/em>.<\/p>\n
main.py<\/em><\/p>\n
from fastapi import FastAPI\n\napp = FastAPI()\n\n@app.get(\"\/\")\ndef read_root():\n    return {\"message\": \"Hello, World!\"}<\/code><\/pre>\n
requirements.txt<\/em><\/p>\n
fastapi\nuvicorn<\/code><\/pre>\n
Uploading files<\/h2>\n
If you try to upload a file to a server and receive a 413 status with the error message\u00a0\u201cError: Request Entity Too Large\u201d<\/em>, it is likely because Nginx has a limit on the maximum file size that can be uploaded. To resolve this issue, go to the Nginx configuration file and specify the maximum allowed file size by using the\u00a0client_max_body_size<\/em>\u00a0directive (setting it to 0 indicates no limits on input file sizes):<\/p>\n
server {\n  listen 80;\n  server_name <PUBLIC_IP_ADDRESS>;\n  location \/ {\n    proxy_pass http:\/\/127.0.0.1:8000;\n    client_max_body_size 0;\n  }\n}<\/code><\/pre>\n
After changing the configuration file, do not forget to restart Nginx.<\/p>\n
Conclusion<\/h2>\n
In this article, we have learned how to quickly create a running EC2 instance using a FastAPI server as an example. Although we did not follow the best deployment and security practices, the main goal of the article was to provide minimal information for beginners to launch their first server on AWS.<\/p>\n
\n
The next logical step in the AWS study roadmap would be creating multiple EC2 instances and connecting them to each other.<\/p>\n<\/blockquote>\n
All images unless otherwise noted are by the author.<\/em><\/p>\n
Connect with me<\/h2>\n