Serving static files in FastAPI

Introduction

Serving static files lets your web app show images, styles, or scripts directly to users. It helps display things like pictures or CSS without extra coding.

You want to show images like logos or photos on your website.

You need to add CSS files to style your web pages.

You want to serve JavaScript files for interactive features.

You have downloadable files like PDFs or documents for users.

You want to serve favicon or icons for your website.

Syntax

FastAPI

from fastapi import FastAPI
from fastapi.staticfiles import StaticFiles

app = FastAPI()

app.mount("/static", StaticFiles(directory="path_to_static_files"), name="static")

The mount method connects a URL path to a folder with static files.

The directory is where your static files are stored on your computer.

Examples

Serve files from a folder named static in your project root at URL path /static.

FastAPI

app.mount("/static", StaticFiles(directory="./static"), name="static")

Serve files from assets folder at URL path /assets.

FastAPI

app.mount("/assets", StaticFiles(directory="assets"), name="assets")

Serve files from an absolute path on your system at /files URL.

FastAPI

app.mount("/files", StaticFiles(directory="/var/www/files"), name="files")

Sample Program

This program creates a FastAPI app that serves any file inside the ./static folder at the URL path /static. For example, if you have an image named example.png inside ./static, you can open it in your browser at http://localhost:8000/static/example.png.

FastAPI

from fastapi import FastAPI
from fastapi.staticfiles import StaticFiles

app = FastAPI()

# Mount the static directory to serve files under /static URL
app.mount("/static", StaticFiles(directory="./static"), name="static")

# Run this app and visit http://localhost:8000/static/example.png to see the image if it exists in ./static folder

Important Notes

Make sure the static folder exists and has the files you want to serve.

Static files are served as-is; FastAPI does not process them.

Use meaningful URL paths to organize your static files for easier access.

Summary

Use app.mount with StaticFiles to serve static files in FastAPI.

Static files include images, CSS, JavaScript, and other resources.

Access static files via the URL path you set in mount.

Practice

1. What is the main purpose of using StaticFiles in a FastAPI application?

easy

A. To serve images, CSS, and JavaScript files to users

B. To handle database connections

C. To create API endpoints for data processing

D. To manage user authentication

Solution

1. Step 1: Understand StaticFiles role

   StaticFiles is used to serve static content like images, CSS, and JavaScript files in FastAPI.

2. Step 2: Compare with other options

   Database handling, API endpoints, and authentication are unrelated to static file serving.

3. Final Answer:

   To serve images, CSS, and JavaScript files to users -> Option A

4. Quick Check:

   StaticFiles serves static content = A [OK]

Hint: StaticFiles always serves static content like images or CSS [OK]

Common Mistakes:

• Confusing StaticFiles with API route handlers
• Thinking StaticFiles manages databases
• Assuming StaticFiles handles user login

2. Which of the following is the correct way to mount a static folder named 'assets' at URL path '/static' in FastAPI?

easy

A. app.route('/static').static_files('assets')

B. app.mount('/static', StaticFiles(directory='assets'), name='static')

C. app.add_static('/static', 'assets')

D. app.static('/assets', directory='/static')

Solution

1. Step 1: Recall FastAPI static file syntax

   The correct method is app.mount(path, StaticFiles(directory=folder), name=alias).

2. Step 2: Match syntax with options

   app.mount('/static', StaticFiles(directory='assets'), name='static') matches this pattern exactly, mounting 'assets' at '/static'. Others use invalid methods.

3. Final Answer:

   app.mount('/static', StaticFiles(directory='assets'), name='static') -> Option B

4. Quick Check:

   Use app.mount with StaticFiles = D [OK]

Hint: Use app.mount with StaticFiles and directory parameter [OK]

Common Mistakes:

• Using app.static or app.add_static which don't exist
• Swapping URL path and directory names
• Omitting the name parameter

3. Given this FastAPI code snippet:

from fastapi import FastAPI
from fastapi.staticfiles import StaticFiles

app = FastAPI()
app.mount('/files', StaticFiles(directory='myfiles'), name='files')

What URL path should you visit in a browser to access a file named image.png inside the myfiles folder?

medium

A. /myfiles/image.png

B. /static/image.png

C. /files/image.png

D. /image.png

Solution

1. Step 1: Identify mount path and directory

   The static files are mounted at URL path '/files' serving from folder 'myfiles'.

2. Step 2: Construct URL for file

   To access 'image.png' inside 'myfiles', visit '/files/image.png' in the browser.

3. Final Answer:

   /files/image.png -> Option C

4. Quick Check:

   URL path matches mount path + filename = B [OK]

Hint: URL path equals mount path plus file name [OK]

Common Mistakes:

• Using directory name as URL path instead of mount path
• Assuming '/static' is default path
• Trying to access file without mount prefix

4. What is wrong with this FastAPI code for serving static files?

from fastapi import FastAPI
from fastapi.staticfiles import StaticFiles

app = FastAPI()
app.mount('/static', StaticFiles('static'), name='static')

medium

A. The URL path '/static' is invalid

B. app.mount cannot be used for static files

C. The name parameter is missing

D. Nothing is wrong with this code

Solution

1. Step 1: Check StaticFiles usage

   StaticFiles('static') is correct because the first positional argument binds to the directory parameter.

2. Step 2: Validate other parts

   app.mount is correct for static files, name parameter is present, and '/static' is a valid URL path.

3. Final Answer:

   Nothing is wrong with this code -> Option D

4. Quick Check:

   StaticFiles('static') correctly sets directory='static' = A [OK]

Hint: StaticFiles accepts positional argument for directory [OK]

Common Mistakes:

• Thinking StaticFiles requires named directory parameter
• Thinking app.mount can't serve static files
• Confusing URL path with directory name

5. You want to serve two different static folders in your FastAPI app: 'images' at '/img' and 'scripts' at '/js'. Which code correctly mounts both folders?

hard

A. app.mount('/img', StaticFiles(directory='images'), name='images')
app.mount('/js', StaticFiles(directory='scripts'), name='scripts')

B. app.mount('/images', StaticFiles(directory='img'), name='img')
app.mount('/scripts', StaticFiles(directory='js'), name='js')

C. app.static('/img', 'images')
app.static('/js', 'scripts')

D. app.add_static('/img', 'images')
app.add_static('/js', 'scripts')

Solution

1. Step 1: Verify correct mount syntax

   Use app.mount(path, StaticFiles(directory=folder), name=alias) for each static folder.

2. Step 2: Match folders and paths

   app.mount('/img', StaticFiles(directory='images'), name='images') app.mount('/js', StaticFiles(directory='scripts'), name='scripts') correctly mounts 'images' at '/img' and 'scripts' at '/js'. Options A, B, D use wrong paths or invalid methods.

3. Final Answer:

   app.mount('/img', StaticFiles(directory='images'), name='images') app.mount('/js', StaticFiles(directory='scripts'), name='scripts') -> Option A

4. Quick Check:

   Mount each folder with app.mount and StaticFiles = C [OK]

Hint: Mount each folder separately with app.mount and StaticFiles [OK]

Common Mistakes:

• Swapping folder names and URL paths
• Using non-existent app.static or app.add_static methods
• Missing name parameter in mount