Deploying Your FastAPI Authentication System and Jekyll Site

Learn the best practices for deploying your FastAPI application with user authentication and integrating it with your Jekyll static site to production.

By Kevin McAleer,    3 Minutes

Deploying FastAPI and Jekyll


Deploying your FastAPI application and Jekyll site involves several steps to ensure that your application is secure, efficient, and accessible to your audience. This lesson will guide you through the deployment process, focusing on best practices and essential considerations.

Pre-Deployment Checklist

Before deploying your application, ensure that:

  1. Security Measures Are in Place: This includes using HTTPS, securing sensitive data, and implementing proper authentication and authorization checks.
  2. Environment Variables Are Configured: Store configuration and secrets in environment variables instead of hard-coding them in your application.
  3. Database Is Ready for Production: Ensure that your database is properly set up, optimized, and securely accessible by your application.
  4. Static Files Are Optimized: For Jekyll, ensure that your static files (images, CSS, JS) are minimized and optimized for faster loading.

Deploying FastAPI

Choosing a Hosting Service

Several cloud providers and hosting services support FastAPI applications, including Heroku, AWS (with Elastic Beanstalk or EC2), Google Cloud Platform, and DigitalOcean. The choice depends on your project’s needs, budget, and preferred infrastructure.

Dockerizing Your Application

Containerizing your FastAPI application with Docker simplifies deployment and ensures consistency across different environments. Here’s a simple Dockerfile example:

FROM python:3.8


COPY requirements.txt ./
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

CMD ["uvicorn", "main:app", "--host", "", "--port", "80"]

Deployment Process

  • Build your Docker image and push it to a container registry.
  • Deploy your container to the chosen hosting service.
  • Ensure that your service is configured to restart your container automatically in case of failure.

Deploying Jekyll

Jekyll sites can be deployed to a variety of hosting services, including GitHub Pages, Netlify, and Vercel. These platforms often provide continuous deployment from your Git repository, making updates straightforward.

  1. Build Your Jekyll Site: Run jekyll build to generate the static files for your site.
  2. Configure Deployment: Depending on your hosting service, you may need to configure specific deployment settings or files.
  3. Continuous Deployment: If supported, set up continuous deployment to automatically build and deploy your site when you push changes to your repository.

Integrating FastAPI with Jekyll

Ensure that your Jekyll site is configured to communicate with your FastAPI application. This may involve setting API endpoint URLs as environment variables or configuring CORS settings on your FastAPI application to accept requests from your Jekyll site’s domain.


Deploying your FastAPI application and Jekyll site to production involves careful planning and attention to security, performance, and reliability. By following best practices and utilizing modern deployment tools and services, you can ensure that your application is ready for your users.

Additional Resources

Lesson Assignment

Deploy a simple FastAPI application and integrate it with a Jekyll static site on a hosting service of your choice. Document the steps you took and any challenges you faced during the deployment process.

< Previous