Question 1

How do I install uftpd on ESP8266?

Accepted Answer

For ESP8266, uftpd must be integrated into the flash image as frozen bytecode by placing it in esp8266/modules and rebuilding, or compiled to .mpy using mpy-cross. The README recommends the frozen bytecode variant for stability.

Question 2

Can uftpd handle multiple file transfers at once?

Accepted Answer

No, uftpd has limited multi-session support; it accepts multiple sessions but serves only one command at a time, with others receiving busy responses. This can cause issues with clients like Nautilus that try to open multiple sessions for file copies.

Question 3

How do I add password protection to uftpd?

Accepted Answer

The README states user authentication may be added easily if required, but out-of-the-box, it has no authentication. You would need to modify the uftpd.py source code to implement it, which requires programming knowledge.

Question 4

uftpd vs other FTP servers for MicroPython: which is better?

Accepted Answer

uftpd is optimized for minimal footprint and broad client compatibility on ESP8266/ESP32, but lacks features like authentication and full concurrency. For more feature-rich or secure options, you might need to look at other MicroPython libraries or custom solutions.

Question 5

Why does Mac Finder not work with uftpd?

Accepted Answer

Mac Finder fails because it requires full multi-session support and never closes sessions properly, which uftpd's limited handling cannot accommodate, as documented in the coverage section of the README.

Question 6

How to run uftpd in foreground mode?

Accepted Answer

uftpd includes a simpler ftp.py script for foreground operation on all MicroPython versions. It runs in the foreground, terminates when the client closes the session, and supports only a single session, as noted in the files section.

Question 7

How do I troubleshoot uftpd connection drops?

Accepted Answer

Check uftpd.client_list to see connected clients, use the rstat command in FTP to show client count, and restart with uftpd.restart() if clients aren't releasing connections. Setting verbose to 2 can provide detailed activity messages for debugging.

FTP-Server-for-ESP8266-ESP32-and-PYBD

What is FTP-Server-for-ESP8266-ESP32-and-PYBD?

Overview

Use Cases

Best For

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions