Uppy-server is a server integration for Uppy file uploader.
It handles the server-to-server communication between your server and file storage providers such as Google Drive, Dropbox, Instagram, etc.
As of now uppy-server is integrated to work with:
npm install uppy-server
Uppy-server may either be used as pluggable express app, which you plug to your already existing server, or it may simply be run as a standalone server:
var express =var bodyParser =var uppy =var app =app...// be sure to place this anywhere after app.use(bodyParser.json())const options =providerOptions:google:key: 'GOOGLE_KEY'secret: 'GOOGLE_SECRET'server:host: 'localhost:3020'protocol: 'http'filePath: '/path/to/folder/'app
See for valid configuration options.
To enable uppy socket for realtime feed to the client while upload is going on, you call the
socket method like so.
...var server = appuppy
Please ensure that the required env varaibles are set before runnning/using uppy-server as a standalone server. See.
If you cloned the repo from gtihub and want to run it as a standalone server, you may also run the following command from within its directory
npm run start:production
To run uppy-server as a standalone server, you are required to set your uppy options via environment variables
####### Mandatory variables ###########export UPPYSERVER_SECRET="shh!Issa Secret!"export UPPYSERVER_DOMAIN="YOUR SERVER DOMAIN"export UPPYSERVER_DATADIR="PATH/TO/DOWNLOAD/DIRECTORY"###### Optionional variables ##########export UPPYSERVER_PROTOCOL="YOUR SERVER PROTOCOL" # defaults to httpexport UPPYSERVER_PORT="YOUR SERVER PORT" # defaults to 3020export UPPYSERVER_PATH="/SERVER/PATH/TO/WHERE/UPPY-SERVER/LIVES" # defaults to ''# use this in place of UPPYSERVER_PATH if the server path should not be# handled by the express.js app but maybe by an external server configuration# instead (e.g Nginx).export UPPYSERVER_IMPLICIT_PATH="/SERVER/PATH/TO/WHERE/UPPY/SERVER/LIVES"# camma separated client hosts to whitlelist by the server# if not specified, the server would allow any hostexport UPPY_ENDPOINTS="localhost:3452,uppy.io"# To enable redis session storage# and enable upload progress storageexport UPPYSERVER_REDIS_URL="REDIS URL"# If used with Dropboxexport UPPYSERVER_DROPBOX_KEY="YOUR DROPBOX KEY"export UPPYSERVER_DROPBOX_SECRET="YOUR DROPBOX SECRET"# If used with Google Driveexport UPPYSERVER_GOOGLE_KEY="YOUR GOOGLE KEY"export UPPYSERVER_GOOGLE_SECRET="YOUR GOOGLE SECRET"# If used with Instagram Driveexport UPPYSERVER_INSTAGRAM_KEY="YOUR INSTAGRAM KEY"export UPPYSERVER_INSTAGRAM_SECRET="YOUR INSTAGRAM SECRET"# If used with s3export UPPYSERVER_AWS_KEY="YOUR AWS KEY"export UPPYSERVER_AWS_SECRET="YOUR AWS SECRET"export UPPYSERVER_AWS_BUCKET="YOUR AWS S3 BUCKET"export UPPYSERVER_AWS_REGION="AWS REGION"# for multiple server instances with multiple subdomainsexport UPPYSERVER_OAUTH_DOMAIN="sub.domain.com"export UPPYSERVER_DOMAINS="sub1.domain.com,sub2.domain.com,sub3.domain.com"# Only set this variable if you want uppy server to set the "i-am" header# in every response.export UPPYSERVER_SELF_ENDPOINT="THIS SHOULD BE SAME AS YOUR DOMAIN + PATH"
providerOptions:google:key: "***"secret: "***"dropbox:key: "***"secret: "***"instagram:key: "***"secret: "***"s3:key: "***"secret: "***"bucket: "bucke-name"region: "us-east-1"server:host: "localhost:3020" // or yourdomain.comprotocol: "http"filePath: "path/to/download/folder"sendSelfEndpoint: "localhost:3020"
filePath(required) - Full path to the directory where provider files would temporarily be downloaded to.
redisUrl(optional) - URL to running redis server. If this is set, the state of uploads would be stored temporarily. This helps for resumed uploads after a browser crash from the client. The stored upload would be sent back to the client on reconnection.
providerOptions(optional) - An object containing credentials (
secret) for each provider you would like to enable. Please see for supported providers.
server(optional) - An object with details mainly used to carry out oauth authentication from any of the enable providers above. Though it is optional, it is required if you would be enabling any of the supported providers. The following are the server options you may set
http | https
mydomain.com/uppy, then the path would be
sub1.mydomain.com) to handle your oauth authentication for you. This would then redirect to the slave subdomain with the required credentials on completion.
oauthDomain, you need to set a list of valid hosts, so the master oauth handler can validate the host of the uppy instance requesting the authentication. This is basically a list of valid domains running your uppy server instances. The list may also contain regex patterns. e.g
['sub2.mydomain.com', 'sub3.mydomain.com', '(\\w+).mydomain.com']
sendSelfEndpoint(optional) - This is basically the same as the
server.host + server.path attributes. The major reason for this attributes is that, when set, it adds the value as the
i-am header of every request response.
customProviders(optional) - This option enables you add custom providers along with the already supported providers. See for more.
As of now, uppy-server supports Google Drive, Dropbox and Instagram out of the box, but you may also choose to add your custom providers. You can do this by passing the
option when calling the uppy
app method. The custom provider is expected to supoort Oauth 1 or 2 for authentication/authorization.
let options =customProviders:myprovidername:config:authorize_url: ""access_url: ""oauth: 2key: "***"secret: "**"scope: "read" "write"module:uppy
customProviders option should be an object containing each custom provider.
Each custom provider would in turn be an object with two keys,
config option would contain Oauth API settings, while the
module would point to the provider module.
To work well with uppy server, the Module must be a class with the following methods.
list (options, done)- lists json data of user files (e.g list of all the files in a particular directory).
options- is an object containing the following attributes
id/nameof the directory whose data is to be retrieved. This may be ignored if it doesn't apply to your provider
done (err, response, body)- the callback that should be called when the request to your provider is done. As the signature indicates the following data should be passed along to the callback
download (options, onData, onResponse)- downloads a particular file from the provider.
options- is an object containing the following attributes
onData (chunk)- a callback that should be called with each data chunk received on download. This is useful if the size of the downloaded file can be pre-determined. This would allow for pipelined upload of the file(to the desired destination), while the download is still going on.
onResponse (response)- if the size of the downloaded file can not be pre-determined by uppy-server, then this callback should be called in place of the
onDatacallback. This callback would be called after the download is done, and would the downloaded data(response) as argument.
git clone https://github.com/transloadit/uppy-server && cd uppy-server && npm install
env.shand edit it to its correct values.
cp env.example.sh env.sh$EDITOR env.sh
npm run start
This would get the uppy-server running on
It also expects the uppy client to be running on
All the secrets are stored in
env.infra.sh, so using
env.infra.example.sh, you could
use the same Freyfile but target a different cloud vendor with different secrets, and run your own
Requires Frey, if you haven't set it up yet type
npm run install:frey
afterwards, production logs are available through:
npm run logtail
This requires at least the
FREY_ENCRYPTION_SECRET key present in your