Skip to content

Install TNFSJD Web on Docker

Brett Smith edited this page Nov 23, 2025 · 2 revisions

This guide is for tnfsjd-web, the web based front-end for TNFS Java. One of the most convenient ways to deploy a server these days is using Docker. This guide explains how.

Every effort is made to provide a working TNFS-Web server out of the box, but you will most likely want to tune things a bit.

Pre-requisites

You will need a TNFS server. For best results of course I recommend tnfsjd, but any other will do.

Quick Start

docker run bithatch/tnfsjd-web -p 14080:14080/tcp -p 14443:14443/tcp -v /path/to/config:/configuration

In Depth

Exactly how you configure all parameters for the Docker distribution will depend on your favourite Docker tools, but here are the basics you will always need.

Volumes

Path Description
/configuration For your configuration overrides (if any). Empty by default. May contain tnfsjd-web/tnfsjd-web.ini and tnfsjd/mounts.ini. See general documentation for configuration file explanation.

Ports

Port Protocol Description
14080 HTTP The TNFS HTTP Web server.
14443 HTTPS The TNFS HTTPS Web server (requires further configuration).

Environment Variables

Variable Default Description
TNFS_MOUNT_HOSTNAME localhost The hostname where a TNFS server is running
TNFS_MOUNT_PORT 16384 The port on which the TNFS server is running
TNFS_MOUNT_PATH / The path the TNFS server is exporting
TNFS_MOUNT_PROTOCOL UDP The protocol the TNFS is using
TNFS_MOUNT_NAME Local TNFS A short name for the resource
LOG_LEVEL INFO The detail level of log output. May be (from least to most detail) ERROR, WARN, INFO, DEBUG or TRACE

What Next?

Test the web server is running by point your browser to http://your-hostname:14080. You should see the file browser interface and be able to view the share you configured with environment variables. Try uploading a few files, creating folders, deleting and renaming files.

Clone this wiki locally