microsnailapps/filezilla repository overview

⁠FileZilla FTP Client

This is FileZilla FTP Client (filezilla-project.org)⁠ run in a Docker container. It was built and tested on Windows host, but should run on Mac or Linux also.

The image contains also Geany editor (geany.org)⁠ to allow editing files on the server.

As it is a GUI application it needs X11 server running on a host - VcXsrv (sourceforge.net/projects/vcxsrv)⁠ is a good option for Windows.

⁠How to use it

⁠1. Start X11 server

You can use any X11 server. The command bellow shows start of VcXsrv on Windows:

vcxsrv.exe :0 -ac +bs -reset -terminate -dpi auto -render color -lesspointer -multiwindow -multimonitors +xinerama -clipboard -emulate3buttons -hostintitle -keyhook -wgl -swrastwgl -winkill

This will enable to start docker application in a standard window with clipboard mapped to/from container.

⁠2. Start the app

To start the app run:

docker run -d --rm -v $HOSTCONFIG:/config:rw -v $HOSTSTORAGE:/storage:rw microsnailapps/filezilla

The -v $HOSTCONFIG:/config part of the command mounts $HOSTCONFIG directory from the underlying host system as /config inside the container, where FileZilla will store its profile data. The -v $HOSTSTORAGE:/storage then gives FileZilla access to files on host system.

NOTE: for Linux host you should also add mount of X11 directory like -v /tmp/.X11-unix:/tmp/.X11-unix.

To access services on host system (e.g. database), use host.docker.internal as hostname (supported by default on Docker Desktop for Win and Mac from 18.03).

⁠Configuration

Most of settings are built into the image, however some of them can be changed on runtime via environment variables or commands.

⁠Timezone

The default timezone of the image is Europe/Prague. However, you can change it by passing environment variable on container start -e "TZ=$YOURTIMEZONE".

⁠Display

The default DISPLAY value is host.docker.internal:0.0, which resolves to host address in Docker Desktop for Windows and Mac from version 18.03. Until Linux Docker distribution will supported this also, you can override the default on start by -e "DISPLAY=$YOURDISPLAYVALUE".

⁠Keyboard input language

The default keyboard language is US (QWERTY). Unfortunatelly, it cannot be changed by any shortcut, but following command will do the trick:

docker exec $CONTAINER setxkbmap $KB

where $KB is two letter identification of keyboard language, e.g. us for US keyboard, cz for Czech keyboard.

⁠Font size

Display font size can be adjusted using environment variable GDK_DPI_SCALE. It is set to 0.8 by default, but you can change it by passing another value on container start -e "GDK_DPI_SCALE=$YOURVALUE".

Note: Font size adjustment works for included Geany editor only.

⁠Image tags info

Different images containd different Filezilla version on based on different underlying Ubuntu version:

• tag 2.28-18.04 contains Filezilla 2.28 on Ubuntu 18.04. It is the stable and supported version.
• tag 3.33.0 contains Filezilla 3.33.0 on Ubuntu 19.10. Than Ubuntu branch is discontinued already.
• tag 3.46.3-20.04 contains Filezilla 3.46.3 on Ubuntu 20.04, which is not yet officially release. However once it is, this will become the primary version we will update in the future. The 'latest' tag already points to this image.

⁠More resources

You can find more information (like Dockerfile, helper scripts and contact) at Microsnail docker apps and utils⁠ page.