Skip to content


Repository files navigation File Upload Server

This library provides an Upload Server/Proxy for use with the File Component and URL configuration. This allows for Private file upload and downloads by sending Authentication requests to the API Server to determine if a user has permissions to upload or download based on their access to either Submit the form, or fetch the Submission JSON respectively.

Getting Started

This library can be ran within 3 different environments.

  1. Locally using Node.js
  2. Docker container
  3. AWS Lambda

Running locally with Node.js

In order to run this server locally, you can type the following within your terminal.

npm install
node index

Running within Docker

To run this with docker, you can use the following commands.

docker run -itd \
  -e "PORT=4100" \
  -e "MAX_UPLOAD_SIZE=16mb" \
  -e "DEBUG=*" \
  -e "PROVIDERS=file,alfresco" \
  -e "UPLOAD_DIR=" \
  -e "ALFRESCO_USER=admin" \
  -e "ALFRESCO_PASS=admin" \
  --restart unless-stopped \
  --name formio-upload \
  -p 4100:4100 \

Running within AWS Lambda

Before you can run with AWS Lambda, you must first install Claudia.

npm install claudia -g

Next, you will want to configure your access credentials to the AWS CLI. You can do this by following the instructions @

Once you have access setup, you can now modify the deploy scripts within package.json to change where this script will be deployed. Once you have made changes to the deploy script within package.json, you can now run the following to deploy this within AWS Lambda using the deploy script.

npm run deploy

Environment Variables.

You must use Environment variables to configure the runtime operation of this server. When running this server locally using Node.js, you can set the Environment variables within the .env file. These variables are defined as follows.

Variable Description Default
PORT The port you wish to run the server on. 4100
MAX_UPLOAD_SIZE The maximum upload size for files being uploaded. 16mb
DEBUG Enables debugging *
PROVIDERS Determines which upload providers are enabled. This is a CSV of the providers you wish to enable. For example "file,alfresco" will enable both local file uploads as well as Alfresco ECM uploads. file
UPLOAD_DIR When using the "file" provider, this is the local upload base directory. providers/uploads
ALFRESCO_USER When using the Alfresco provider, this is the user account to log into the Alfresco ECM admin
ALFRESCO_PASS When using the Alfresco provider, this is the user account password to log into the Alfresco ECM admin
ALFRESCO_HOST When using the Alfresco provider, this is the Alfresco ECM server URL

Configure Form Upload

Now that you have the server running, you can configure a Form with a new File component.

Within the configuration of this File component, you will need to set the file upload type to URL and then provide the URL of this service. You can decide which upload provider to use based on the path you provide to the url of the running server.

For example:

You will also need to make sure you check Private Download.

The upload will now function against this server.


A file upload server/proxy for use with the file component.







No packages published