](https://github.com/kiloreux) |[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4&s=117)
](https://github.com/apps/dependabot) |[
](https://github.com/samuelayo) |[
](https://github.com/sadovnychyi) |[
](https://github.com/richardwillars) |[
](https://github.com/ajkachnic) |
+[](https://github.com/apps/dependabot) |[](https://github.com/kiloreux) |[](https://github.com/samuelayo) |[](https://github.com/sadovnychyi) |[](https://github.com/richardwillars) |[](https://github.com/ajkachnic) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[kiloreux](https://github.com/kiloreux) |[dependabot\[bot\]](https://github.com/apps/dependabot) |[samuelayo](https://github.com/samuelayo) |[sadovnychyi](https://github.com/sadovnychyi) |[richardwillars](https://github.com/richardwillars) |[ajkachnic](https://github.com/ajkachnic) |
+[dependabot\[bot\]](https://github.com/apps/dependabot) |[kiloreux](https://github.com/kiloreux) |[samuelayo](https://github.com/samuelayo) |[sadovnychyi](https://github.com/sadovnychyi) |[richardwillars](https://github.com/richardwillars) |[ajkachnic](https://github.com/ajkachnic) |
[
](https://github.com/zcallan) |[
](https://github.com/YukeshShr) |[
](https://github.com/janko) |[
](https://github.com/oliverpool) |[
](https://github.com/Botz) |[
](https://github.com/mcallistertyler) |
:---: |:---: |:---: |:---: |:---: |:---: |
@@ -275,53 +275,53 @@ Use Uppy in your project? [Let us know](https://github.com/transloadit/uppy/issu
:---: |:---: |:---: |:---: |:---: |:---: |
[dogrocker](https://github.com/dogrocker) |[jedwood](https://github.com/jedwood) |[jasonbosco](https://github.com/jasonbosco) |[ghasrfakhri](https://github.com/ghasrfakhri) |[geertclerx](https://github.com/geertclerx) |[frobinsonj](https://github.com/frobinsonj) |
-[
](https://github.com/eman8519) |[
](https://github.com/luarmr) |[
](https://github.com/raulibanez) |[
](https://github.com/refo) |[
](https://github.com/SxDx) |[
](https://github.com/robwilson1) |
+[
](https://github.com/neuronet77) |[
](https://github.com/rossng) |[
](https://github.com/scherroman) |[](https://github.com/robwilson1) |[](https://github.com/SxDx) |[](https://github.com/refo) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[eman8519](https://github.com/eman8519) |[luarmr](https://github.com/luarmr) |[raulibanez](https://github.com/raulibanez) |[refo](https://github.com/refo) |[SxDx](https://github.com/SxDx) |[robwilson1](https://github.com/robwilson1) |
+[neuronet77](https://github.com/neuronet77) |[rossng](https://github.com/rossng) |[scherroman](https://github.com/scherroman) |[robwilson1](https://github.com/robwilson1) |[SxDx](https://github.com/SxDx) |[refo](https://github.com/refo) |
-[](https://github.com/scherroman) |[](https://github.com/neuronet77) |[
](https://github.com/Pzoco) |[
](https://github.com/ppadmavilasom) |[
](https://github.com/phillipalexander) |[
](https://github.com/pmusaraj) |
+[](https://github.com/raulibanez) |[](https://github.com/luarmr) |[](https://github.com/eman8519) |[](https://github.com/Pzoco) |[](https://github.com/ppadmavilasom) |[](https://github.com/phillipalexander) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[scherroman](https://github.com/scherroman) |[neuronet77](https://github.com/neuronet77) |[Pzoco](https://github.com/Pzoco) |[ppadmavilasom](https://github.com/ppadmavilasom) |[phillipalexander](https://github.com/phillipalexander) |[pmusaraj](https://github.com/pmusaraj) |
+[raulibanez](https://github.com/raulibanez) |[luarmr](https://github.com/luarmr) |[eman8519](https://github.com/eman8519) |[Pzoco](https://github.com/Pzoco) |[ppadmavilasom](https://github.com/ppadmavilasom) |[phillipalexander](https://github.com/phillipalexander) |
-[
](https://github.com/pedrofs) |[
](https://github.com/plneto) |[
](https://github.com/patricklindsay) |[
](https://github.com/pascalwengerter) |[
](https://github.com/ParsaArvanehPA) |[
](https://github.com/taj) |
+[](https://github.com/pmusaraj) |[](https://github.com/pedrofs) |[](https://github.com/plneto) |[](https://github.com/patricklindsay) |[](https://github.com/pascalwengerter) |[
](https://github.com/Tashows) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[pedrofs](https://github.com/pedrofs) |[plneto](https://github.com/plneto) |[patricklindsay](https://github.com/patricklindsay) |[pascalwengerter](https://github.com/pascalwengerter) |[ParsaArvanehPA](https://github.com/ParsaArvanehPA) |[taj](https://github.com/taj) |
+[pmusaraj](https://github.com/pmusaraj) |[pedrofs](https://github.com/pedrofs) |[plneto](https://github.com/plneto) |[patricklindsay](https://github.com/patricklindsay) |[pascalwengerter](https://github.com/pascalwengerter) |[Tashows](https://github.com/Tashows) |
-[
](https://github.com/strayer) |[
](https://github.com/sjauld) |[
](https://github.com/steverob) |[
](https://github.com/amaitu) |[
](https://github.com/quigebo) |[
](https://github.com/waptik) |
+[](https://github.com/taj) |[](https://github.com/strayer) |[](https://github.com/sjauld) |[](https://github.com/steverob) |[](https://github.com/amaitu) |[](https://github.com/quigebo) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[strayer](https://github.com/strayer) |[sjauld](https://github.com/sjauld) |[steverob](https://github.com/steverob) |[amaitu](https://github.com/amaitu) |[quigebo](https://github.com/quigebo) |[waptik](https://github.com/waptik) |
+[taj](https://github.com/taj) |[strayer](https://github.com/strayer) |[sjauld](https://github.com/sjauld) |[steverob](https://github.com/steverob) |[amaitu](https://github.com/amaitu) |[quigebo](https://github.com/quigebo) |
-[
](https://github.com/SpazzMarticus) |[
](https://github.com/szh) |[
](https://github.com/sergei-zelinsky) |[
](https://github.com/sebasegovia01) |[
](https://github.com/sdebacker) |[
](https://github.com/samuelcolburn) |
+[](https://github.com/waptik) |[](https://github.com/SpazzMarticus) |[](https://github.com/szh) |[](https://github.com/sergei-zelinsky) |[](https://github.com/sebasegovia01) |[](https://github.com/sdebacker) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[SpazzMarticus](https://github.com/SpazzMarticus) |[szh](https://github.com/szh) |[sergei-zelinsky](https://github.com/sergei-zelinsky) |[sebasegovia01](https://github.com/sebasegovia01) |[sdebacker](https://github.com/sdebacker) |[samuelcolburn](https://github.com/samuelcolburn) |
+[waptik](https://github.com/waptik) |[SpazzMarticus](https://github.com/SpazzMarticus) |[szh](https://github.com/szh) |[sergei-zelinsky](https://github.com/sergei-zelinsky) |[sebasegovia01](https://github.com/sebasegovia01) |[sdebacker](https://github.com/sdebacker) |
-[
](https://github.com/fortunto2) |[
](https://github.com/GNURub) |[
](https://github.com/rart) |[](https://github.com/rossng) |[
](https://github.com/mkopinsky) |[
](https://github.com/mhulet) |
+[](https://github.com/samuelcolburn) |[](https://github.com/fortunto2) |[](https://github.com/GNURub) |[](https://github.com/rart) |[
](https://github.com/ken-kuro) |[](https://github.com/mkopinsky) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[fortunto2](https://github.com/fortunto2) |[GNURub](https://github.com/GNURub) |[rart](https://github.com/rart) |[rossng](https://github.com/rossng) |[mkopinsky](https://github.com/mkopinsky) |[mhulet](https://github.com/mhulet) |
+[samuelcolburn](https://github.com/samuelcolburn) |[fortunto2](https://github.com/fortunto2) |[GNURub](https://github.com/GNURub) |[rart](https://github.com/rart) |[ken-kuro](https://github.com/ken-kuro) |[mkopinsky](https://github.com/mkopinsky) |
-[
](https://github.com/hrsh) |[
](https://github.com/mauricioribeiro) |[
](https://github.com/matthewhartstonge) |[
](https://github.com/mjesuele) |[
](https://github.com/mattfik) |[
](https://github.com/mateuscruz) |
+[](https://github.com/mhulet) |[](https://github.com/hrsh) |[](https://github.com/mauricioribeiro) |[](https://github.com/matthewhartstonge) |[](https://github.com/mjesuele) |[](https://github.com/mattfik) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[hrsh](https://github.com/hrsh) |[mauricioribeiro](https://github.com/mauricioribeiro) |[matthewhartstonge](https://github.com/matthewhartstonge) |[mjesuele](https://github.com/mjesuele) |[mattfik](https://github.com/mattfik) |[mateuscruz](https://github.com/mateuscruz) |
+[mhulet](https://github.com/mhulet) |[hrsh](https://github.com/hrsh) |[mauricioribeiro](https://github.com/mauricioribeiro) |[matthewhartstonge](https://github.com/matthewhartstonge) |[mjesuele](https://github.com/mjesuele) |[mattfik](https://github.com/mattfik) |
-[
](https://github.com/masumulu28) |[
](https://github.com/masaok) |[
](https://github.com/martin-brennan) |[
](https://github.com/marcusforsberg) |[
](https://github.com/marcosthejew) |[
](https://github.com/mperrando) |
+[](https://github.com/mateuscruz) |[](https://github.com/masumulu28) |[](https://github.com/masaok) |[](https://github.com/martin-brennan) |[](https://github.com/marcusforsberg) |[](https://github.com/marcosthejew) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[masumulu28](https://github.com/masumulu28) |[masaok](https://github.com/masaok) |[martin-brennan](https://github.com/martin-brennan) |[marcusforsberg](https://github.com/marcusforsberg) |[marcosthejew](https://github.com/marcosthejew) |[mperrando](https://github.com/mperrando) |
+[mateuscruz](https://github.com/mateuscruz) |[masumulu28](https://github.com/masumulu28) |[masaok](https://github.com/masaok) |[martin-brennan](https://github.com/martin-brennan) |[marcusforsberg](https://github.com/marcusforsberg) |[marcosthejew](https://github.com/marcosthejew) |
-[
](https://github.com/onhate) |[
](https://github.com/marc-mabe) |[
](https://github.com/Cruaier) |[
](https://github.com/cryptic022) |[
](https://github.com/Ozodbek1405) |[
](https://github.com/leftdevel) |
+[](https://github.com/mperrando) |[](https://github.com/onhate) |[](https://github.com/marc-mabe) |[](https://github.com/ParsaArvanehPA) |[](https://github.com/cryptic022) |[](https://github.com/Ozodbek1405) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[onhate](https://github.com/onhate) |[marc-mabe](https://github.com/marc-mabe) |[Cruaier](https://github.com/Cruaier) |[cryptic022](https://github.com/cryptic022) |[Ozodbek1405](https://github.com/Ozodbek1405) |[leftdevel](https://github.com/leftdevel) |
+[mperrando](https://github.com/mperrando) |[onhate](https://github.com/onhate) |[marc-mabe](https://github.com/marc-mabe) |[ParsaArvanehPA](https://github.com/ParsaArvanehPA) |[cryptic022](https://github.com/cryptic022) |[Ozodbek1405](https://github.com/Ozodbek1405) |
-[
](https://github.com/nil1511) |[
](https://github.com/coreprocess) |[
](https://github.com/nicojones) |[
](https://github.com/trungcva10a6tn) |[
](https://github.com/naveed-ahmad) |[
](https://github.com/pleasespammelater) |
+[](https://github.com/leftdevel) |[](https://github.com/nil1511) |[](https://github.com/coreprocess) |[](https://github.com/nicojones) |[](https://github.com/trungcva10a6tn) |[](https://github.com/naveed-ahmad) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[nil1511](https://github.com/nil1511) |[coreprocess](https://github.com/coreprocess) |[nicojones](https://github.com/nicojones) |[trungcva10a6tn](https://github.com/trungcva10a6tn) |[naveed-ahmad](https://github.com/naveed-ahmad) |[pleasespammelater](https://github.com/pleasespammelater) |
+[leftdevel](https://github.com/leftdevel) |[nil1511](https://github.com/nil1511) |[coreprocess](https://github.com/coreprocess) |[nicojones](https://github.com/nicojones) |[trungcva10a6tn](https://github.com/trungcva10a6tn) |[naveed-ahmad](https://github.com/naveed-ahmad) |
-[
](https://github.com/marton-laszlo-attila) |[
](https://github.com/navruzm) |[
](https://github.com/mogzol) |[
](https://github.com/shahimclt) |[
](https://github.com/mnafees) |[
](https://github.com/boudra) |
+[](https://github.com/pleasespammelater) |[](https://github.com/marton-laszlo-attila) |[](https://github.com/navruzm) |[](https://github.com/mogzol) |[](https://github.com/shahimclt) |[](https://github.com/mnafees) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[marton-laszlo-attila](https://github.com/marton-laszlo-attila) |[navruzm](https://github.com/navruzm) |[mogzol](https://github.com/mogzol) |[shahimclt](https://github.com/shahimclt) |[mnafees](https://github.com/mnafees) |[boudra](https://github.com/boudra) |
+[pleasespammelater](https://github.com/pleasespammelater) |[marton-laszlo-attila](https://github.com/marton-laszlo-attila) |[navruzm](https://github.com/navruzm) |[mogzol](https://github.com/mogzol) |[shahimclt](https://github.com/shahimclt) |[mnafees](https://github.com/mnafees) |
-[
](https://github.com/achmiral) |[](https://github.com/ken-kuro) |[
](https://github.com/mosi-kha) |[
](https://github.com/maddy-jo) |[
](https://github.com/mdxiaohu) |[
](https://github.com/magumbo) |
+[](https://github.com/boudra) |[](https://github.com/achmiral) |[](https://github.com/mosi-kha) |[](https://github.com/maddy-jo) |[](https://github.com/mdxiaohu) |[](https://github.com/magumbo) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[achmiral](https://github.com/achmiral) |[ken-kuro](https://github.com/ken-kuro) |[mosi-kha](https://github.com/mosi-kha) |[maddy-jo](https://github.com/maddy-jo) |[mdxiaohu](https://github.com/mdxiaohu) |[magumbo](https://github.com/magumbo) |
+[boudra](https://github.com/boudra) |[achmiral](https://github.com/achmiral) |[mosi-kha](https://github.com/mosi-kha) |[maddy-jo](https://github.com/maddy-jo) |[mdxiaohu](https://github.com/mdxiaohu) |[magumbo](https://github.com/magumbo) |
[
](https://github.com/jx-zyf) |[
](https://github.com/kode-ninja) |[
](https://github.com/sontixyou) |[
](https://github.com/jur-ng) |[
](https://github.com/johnmanjiro13) |[
](https://github.com/jyoungblood) |
:---: |:---: |:---: |:---: |:---: |:---: |
@@ -331,9 +331,9 @@ Use Uppy in your project? [Let us know](https://github.com/transloadit/uppy/issu
:---: |:---: |:---: |:---: |:---: |:---: |
[green-mike](https://github.com/green-mike) |[gaelicwinter](https://github.com/gaelicwinter) |[frederikhors](https://github.com/frederikhors) |[franckl](https://github.com/franckl) |[fingul](https://github.com/fingul) |[elliotsayes](https://github.com/elliotsayes) |
-[
](https://github.com/xhocquet) |[
](https://github.com/JimmyLv) |[
](https://github.com/zanzlender) |[
](https://github.com/olitomas) |[
](https://github.com/yoann-hellopret) |[
](https://github.com/vedran555) |
+[
](https://github.com/YehudaKremer) |[](https://github.com/JimmyLv) |[](https://github.com/zanzlender) |[](https://github.com/olitomas) |[](https://github.com/yoann-hellopret) |[](https://github.com/vedran555) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[xhocquet](https://github.com/xhocquet) |[JimmyLv](https://github.com/JimmyLv) |[zanzlender](https://github.com/zanzlender) |[olitomas](https://github.com/olitomas) |[yoann-hellopret](https://github.com/yoann-hellopret) |[vedran555](https://github.com/vedran555) |
+[YehudaKremer](https://github.com/YehudaKremer) |[JimmyLv](https://github.com/JimmyLv) |[zanzlender](https://github.com/zanzlender) |[olitomas](https://github.com/olitomas) |[yoann-hellopret](https://github.com/yoann-hellopret) |[vedran555](https://github.com/vedran555) |
[
](https://github.com/tusharjkhunt) |[
](https://github.com/thanhthot) |[
](https://github.com/stduhpf) |[
](https://github.com/slawexxx44) |[
](https://github.com/rtaieb) |[
](https://github.com/rmoura-92) |
:---: |:---: |:---: |:---: |:---: |:---: |
@@ -343,9 +343,9 @@ Use Uppy in your project? [Let us know](https://github.com/transloadit/uppy/issu
:---: |:---: |:---: |:---: |:---: |:---: |
[rlebosse](https://github.com/rlebosse) |[rhymes](https://github.com/rhymes) |[luntta](https://github.com/luntta) |[phil714](https://github.com/phil714) |[ordago](https://github.com/ordago) |[odselsevier](https://github.com/odselsevier) |
-[
](https://github.com/ninesalt) |[
](https://github.com/willycamargo) |[
](https://github.com/weston-sankey-mark43) |[
](https://github.com/dwnste) |[
](https://github.com/nagyv) |[
](https://github.com/stiig) |
+[](https://github.com/ninesalt) |[](https://github.com/xhocquet) |[](https://github.com/willycamargo) |[](https://github.com/weston-sankey-mark43) |[](https://github.com/dwnste) |[](https://github.com/nagyv) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[ninesalt](https://github.com/ninesalt) |[willycamargo](https://github.com/willycamargo) |[weston-sankey-mark43](https://github.com/weston-sankey-mark43) |[dwnste](https://github.com/dwnste) |[nagyv](https://github.com/nagyv) |[stiig](https://github.com/stiig) |
+[ninesalt](https://github.com/ninesalt) |[xhocquet](https://github.com/xhocquet) |[willycamargo](https://github.com/willycamargo) |[weston-sankey-mark43](https://github.com/weston-sankey-mark43) |[dwnste](https://github.com/dwnste) |[nagyv](https://github.com/nagyv) |
[
](https://github.com/valentinoli) |[
](https://github.com/vially) |[
](https://github.com/trivikr) |[
](https://github.com/top-master) |[
](https://github.com/tvaliasek) |[
](https://github.com/tomekp) |
:---: |:---: |:---: |:---: |:---: |:---: |
@@ -363,105 +363,105 @@ Use Uppy in your project? [Let us know](https://github.com/transloadit/uppy/issu
:---: |:---: |:---: |:---: |:---: |:---: |
[canvasbh](https://github.com/canvasbh) |[c0b41](https://github.com/c0b41) |[avalla](https://github.com/avalla) |[arggh](https://github.com/arggh) |[alfatv](https://github.com/alfatv) |[agreene-coursera](https://github.com/agreene-coursera) |
-[
](https://github.com/aduh95-test-account) |[
](https://github.com/sartoshi-foot-dao) |[
](https://github.com/zackbloom) |[
](https://github.com/zlawson-ut) |[
](https://github.com/zachconner) |[](https://github.com/YehudaKremer) |
+[](https://github.com/aduh95-test-account) |[](https://github.com/sartoshi-foot-dao) |[](https://github.com/zackbloom) |[](https://github.com/zlawson-ut) |[](https://github.com/zachconner) |[
](https://github.com/yafkari) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[aduh95-test-account](https://github.com/aduh95-test-account) |[sartoshi-foot-dao](https://github.com/sartoshi-foot-dao) |[zackbloom](https://github.com/zackbloom) |[zlawson-ut](https://github.com/zlawson-ut) |[zachconner](https://github.com/zachconner) |[YehudaKremer](https://github.com/YehudaKremer) |
+[aduh95-test-account](https://github.com/aduh95-test-account) |[sartoshi-foot-dao](https://github.com/sartoshi-foot-dao) |[zackbloom](https://github.com/zackbloom) |[zlawson-ut](https://github.com/zlawson-ut) |[zachconner](https://github.com/zachconner) |[yafkari](https://github.com/yafkari) |
-[
](https://github.com/sercraig) |[
](https://github.com/ardeois) |[
](https://github.com/CommanderRoot) |[
](https://github.com/czj) |[
](https://github.com/cbush06) |[
](https://github.com/Aarbel) |
+[](https://github.com/Cruaier) |[](https://github.com/sercraig) |[](https://github.com/ardeois) |[](https://github.com/CommanderRoot) |[](https://github.com/czj) |[](https://github.com/cbush06) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[sercraig](https://github.com/sercraig) |[ardeois](https://github.com/ardeois) |[CommanderRoot](https://github.com/CommanderRoot) |[czj](https://github.com/czj) |[cbush06](https://github.com/cbush06) |[Aarbel](https://github.com/Aarbel) |
+[Cruaier](https://github.com/Cruaier) |[sercraig](https://github.com/sercraig) |[ardeois](https://github.com/ardeois) |[CommanderRoot](https://github.com/CommanderRoot) |[czj](https://github.com/czj) |[cbush06](https://github.com/cbush06) |
-[
](https://github.com/cfra) |[
](https://github.com/csprance) |[
](https://github.com/prattcmp) |[
](https://github.com/subvertallchris) |[
](https://github.com/charlybillaud) |[
](https://github.com/Cretezy) |
+[](https://github.com/Aarbel) |[](https://github.com/cfra) |[](https://github.com/csprance) |[](https://github.com/prattcmp) |[](https://github.com/subvertallchris) |[](https://github.com/charlybillaud) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[cfra](https://github.com/cfra) |[csprance](https://github.com/csprance) |[prattcmp](https://github.com/prattcmp) |[subvertallchris](https://github.com/subvertallchris) |[charlybillaud](https://github.com/charlybillaud) |[Cretezy](https://github.com/Cretezy) |
+[Aarbel](https://github.com/Aarbel) |[cfra](https://github.com/cfra) |[csprance](https://github.com/csprance) |[prattcmp](https://github.com/prattcmp) |[subvertallchris](https://github.com/subvertallchris) |[charlybillaud](https://github.com/charlybillaud) |
-[
](https://github.com/chao) |[
](https://github.com/cellvinchung) |[
](https://github.com/cartfisk) |[
](https://github.com/cyu) |[
](https://github.com/radarhere) |[
](https://github.com/kergekacsa) |
+[](https://github.com/Cretezy) |[](https://github.com/chao) |[](https://github.com/cellvinchung) |[](https://github.com/cartfisk) |[](https://github.com/cyu) |[](https://github.com/radarhere) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[chao](https://github.com/chao) |[cellvinchung](https://github.com/cellvinchung) |[cartfisk](https://github.com/cartfisk) |[cyu](https://github.com/cyu) |[radarhere](https://github.com/radarhere) |[kergekacsa](https://github.com/kergekacsa) |
+[Cretezy](https://github.com/Cretezy) |[chao](https://github.com/chao) |[cellvinchung](https://github.com/cellvinchung) |[cartfisk](https://github.com/cartfisk) |[cyu](https://github.com/cyu) |[radarhere](https://github.com/radarhere) |
-[
](https://github.com/eliOcs) |[
](https://github.com/yoldar) |[
](https://github.com/efbautista) |[
](https://github.com/emuell) |[
](https://github.com/EdgarSantiago93) |[
](https://github.com/sweetro) |
+[](https://github.com/kergekacsa) |[](https://github.com/eliOcs) |[](https://github.com/yoldar) |[](https://github.com/efbautista) |[](https://github.com/emuell) |[](https://github.com/EdgarSantiago93) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[eliOcs](https://github.com/eliOcs) |[yoldar](https://github.com/yoldar) |[efbautista](https://github.com/efbautista) |[emuell](https://github.com/emuell) |[EdgarSantiago93](https://github.com/EdgarSantiago93) |[sweetro](https://github.com/sweetro) |
+[kergekacsa](https://github.com/kergekacsa) |[eliOcs](https://github.com/eliOcs) |[yoldar](https://github.com/yoldar) |[efbautista](https://github.com/efbautista) |[emuell](https://github.com/emuell) |[EdgarSantiago93](https://github.com/EdgarSantiago93) |
-[
](https://github.com/jeetiss) |[
](https://github.com/DennisKofflard) |[
](https://github.com/hoangsvit) |[
](https://github.com/davilima6) |[
](https://github.com/akizor) |[
](https://github.com/KaminskiDaniell) |
+[](https://github.com/sweetro) |[](https://github.com/jeetiss) |[](https://github.com/DennisKofflard) |[](https://github.com/hoangsvit) |[](https://github.com/davilima6) |[](https://github.com/akizor) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[jeetiss](https://github.com/jeetiss) |[DennisKofflard](https://github.com/DennisKofflard) |[hoangsvit](https://github.com/hoangsvit) |[davilima6](https://github.com/davilima6) |[akizor](https://github.com/akizor) |[KaminskiDaniell](https://github.com/KaminskiDaniell) |
+[sweetro](https://github.com/sweetro) |[jeetiss](https://github.com/jeetiss) |[DennisKofflard](https://github.com/DennisKofflard) |[hoangsvit](https://github.com/hoangsvit) |[davilima6](https://github.com/davilima6) |[akizor](https://github.com/akizor) |
-[
](https://github.com/Cantabar) |[
](https://github.com/mrboomer) |[
](https://github.com/danilat) |[
](https://github.com/danschalow) |[
](https://github.com/danmichaelo) |[
](https://github.com/functino) |
+[](https://github.com/KaminskiDaniell) |[](https://github.com/Cantabar) |[](https://github.com/mrboomer) |[](https://github.com/danilat) |[](https://github.com/danschalow) |[](https://github.com/danmichaelo) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[Cantabar](https://github.com/Cantabar) |[mrboomer](https://github.com/mrboomer) |[danilat](https://github.com/danilat) |[danschalow](https://github.com/danschalow) |[danmichaelo](https://github.com/danmichaelo) |[functino](https://github.com/functino) |
+[KaminskiDaniell](https://github.com/KaminskiDaniell) |[Cantabar](https://github.com/Cantabar) |[mrboomer](https://github.com/mrboomer) |[danilat](https://github.com/danilat) |[danschalow](https://github.com/danschalow) |[danmichaelo](https://github.com/danmichaelo) |
-[
](https://github.com/amitport) |[
](https://github.com/tekacs) |[
](https://github.com/Dogfalo) |[
](https://github.com/aalepis) |[
](https://github.com/alexnj) |[
](https://github.com/asmt3) |
+[](https://github.com/functino) |[](https://github.com/amitport) |[](https://github.com/tekacs) |[](https://github.com/Dogfalo) |[](https://github.com/aalepis) |[](https://github.com/alexnj) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[amitport](https://github.com/amitport) |[tekacs](https://github.com/tekacs) |[Dogfalo](https://github.com/Dogfalo) |[aalepis](https://github.com/aalepis) |[alexnj](https://github.com/alexnj) |[asmt3](https://github.com/asmt3) |
+[functino](https://github.com/functino) |[amitport](https://github.com/amitport) |[tekacs](https://github.com/tekacs) |[Dogfalo](https://github.com/Dogfalo) |[aalepis](https://github.com/aalepis) |[alexnj](https://github.com/alexnj) |
-[
](https://github.com/ahmadissa) |[
](https://github.com/adritasharma) |[
](https://github.com/Adrrei) |[
](https://github.com/adityapatadia) |[
](https://github.com/adamvigneault) |[
](https://github.com/ajh-sr) |
+[](https://github.com/asmt3) |[](https://github.com/ahmadissa) |[](https://github.com/adritasharma) |[](https://github.com/Adrrei) |[](https://github.com/adityapatadia) |[](https://github.com/adamvigneault) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[ahmadissa](https://github.com/ahmadissa) |[adritasharma](https://github.com/adritasharma) |[Adrrei](https://github.com/Adrrei) |[adityapatadia](https://github.com/adityapatadia) |[adamvigneault](https://github.com/adamvigneault) |[ajh-sr](https://github.com/ajh-sr) |
+[asmt3](https://github.com/asmt3) |[ahmadissa](https://github.com/ahmadissa) |[adritasharma](https://github.com/adritasharma) |[Adrrei](https://github.com/Adrrei) |[adityapatadia](https://github.com/adityapatadia) |[adamvigneault](https://github.com/adamvigneault) |
-[
](https://github.com/adamdottv) |[
](https://github.com/abannach) |[
](https://github.com/superhawk610) |[
](https://github.com/ajschmidt8) |[
](https://github.com/bryanjswift) |[
](https://github.com/bedgerotto) |
+[](https://github.com/ajh-sr) |[](https://github.com/adamdottv) |[](https://github.com/abannach) |[](https://github.com/superhawk610) |[](https://github.com/ajschmidt8) |[](https://github.com/bryanjswift) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[adamdottv](https://github.com/adamdottv) |[abannach](https://github.com/abannach) |[superhawk610](https://github.com/superhawk610) |[ajschmidt8](https://github.com/ajschmidt8) |[bryanjswift](https://github.com/bryanjswift) |[bedgerotto](https://github.com/bedgerotto) |
+[ajh-sr](https://github.com/ajh-sr) |[adamdottv](https://github.com/adamdottv) |[abannach](https://github.com/abannach) |[superhawk610](https://github.com/superhawk610) |[ajschmidt8](https://github.com/ajschmidt8) |[bryanjswift](https://github.com/bryanjswift) |
-[
](https://github.com/wbaaron) |[
](https://github.com/Quorafind) |[
](https://github.com/bducharme) |[
](https://github.com/azizk) |[
](https://github.com/azeemba) |[
](https://github.com/ayhankesicioglu) |
+[](https://github.com/bedgerotto) |[](https://github.com/wbaaron) |[](https://github.com/Quorafind) |[](https://github.com/bducharme) |[](https://github.com/azizk) |[](https://github.com/azeemba) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[wbaaron](https://github.com/wbaaron) |[Quorafind](https://github.com/Quorafind) |[bducharme](https://github.com/bducharme) |[azizk](https://github.com/azizk) |[azeemba](https://github.com/azeemba) |[ayhankesicioglu](https://github.com/ayhankesicioglu) |
+[bedgerotto](https://github.com/bedgerotto) |[wbaaron](https://github.com/wbaaron) |[Quorafind](https://github.com/Quorafind) |[bducharme](https://github.com/bducharme) |[azizk](https://github.com/azizk) |[azeemba](https://github.com/azeemba) |
-[
](https://github.com/atsawin) |[
](https://github.com/ash-jc-allen) |[
](https://github.com/apuyou) |[
](https://github.com/arthurdenner) |[
](https://github.com/Abourass) |[
](https://github.com/tyndria) |
+[](https://github.com/ayhankesicioglu) |[](https://github.com/atsawin) |[](https://github.com/ash-jc-allen) |[](https://github.com/apuyou) |[](https://github.com/arthurdenner) |[](https://github.com/Abourass) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[atsawin](https://github.com/atsawin) |[ash-jc-allen](https://github.com/ash-jc-allen) |[apuyou](https://github.com/apuyou) |[arthurdenner](https://github.com/arthurdenner) |[Abourass](https://github.com/Abourass) |[tyndria](https://github.com/tyndria) |
+[ayhankesicioglu](https://github.com/ayhankesicioglu) |[atsawin](https://github.com/atsawin) |[ash-jc-allen](https://github.com/ash-jc-allen) |[apuyou](https://github.com/apuyou) |[arthurdenner](https://github.com/arthurdenner) |[Abourass](https://github.com/Abourass) |
-[
](https://github.com/anthony0030) |[
](https://github.com/andychongyz) |[
](https://github.com/andrii-bodnar) |[
](https://github.com/superandrew213) |[
](https://github.com/firesharkstudios) |[
](https://github.com/kaspermeinema) |
+[](https://github.com/tyndria) |[](https://github.com/anthony0030) |[](https://github.com/andychongyz) |[](https://github.com/andrii-bodnar) |[](https://github.com/superandrew213) |[](https://github.com/firesharkstudios) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[anthony0030](https://github.com/anthony0030) |[andychongyz](https://github.com/andychongyz) |[andrii-bodnar](https://github.com/andrii-bodnar) |[superandrew213](https://github.com/superandrew213) |[firesharkstudios](https://github.com/firesharkstudios) |[kaspermeinema](https://github.com/kaspermeinema) |
+[tyndria](https://github.com/tyndria) |[anthony0030](https://github.com/anthony0030) |[andychongyz](https://github.com/andychongyz) |[andrii-bodnar](https://github.com/andrii-bodnar) |[superandrew213](https://github.com/superandrew213) |[firesharkstudios](https://github.com/firesharkstudios) |
[
](https://github.com/tykarol) |[
](https://github.com/jvelten) |[
](https://github.com/mellow-fellow) |[
](https://github.com/jmontoyaa) |[
](https://github.com/jcalonso) |[
](https://github.com/jbelej) |
:---: |:---: |:---: |:---: |:---: |:---: |
[tykarol](https://github.com/tykarol) |[jvelten](https://github.com/jvelten) |[mellow-fellow](https://github.com/mellow-fellow) |[jmontoyaa](https://github.com/jmontoyaa) |[jcalonso](https://github.com/jcalonso) |[jbelej](https://github.com/jbelej) |
-[
](https://github.com/jszobody) |[
](https://github.com/jorgeepc) |[
](https://github.com/jondewoo) |[
](https://github.com/jonathanarbely) |[
](https://github.com/jsanchez034) |[
](https://github.com/Jokcy) |
+[](https://github.com/jbelej) |[](https://github.com/jszobody) |[](https://github.com/jorgeepc) |[](https://github.com/jondewoo) |[](https://github.com/jonathanarbely) |[](https://github.com/jsanchez034) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[jszobody](https://github.com/jszobody) |[jorgeepc](https://github.com/jorgeepc) |[jondewoo](https://github.com/jondewoo) |[jonathanarbely](https://github.com/jonathanarbely) |[jsanchez034](https://github.com/jsanchez034) |[Jokcy](https://github.com/Jokcy) |
+[jbelej](https://github.com/jbelej) |[jszobody](https://github.com/jszobody) |[jorgeepc](https://github.com/jorgeepc) |[jondewoo](https://github.com/jondewoo) |[jonathanarbely](https://github.com/jonathanarbely) |[jsanchez034](https://github.com/jsanchez034) |
-[
](https://github.com/chromacoma) |[
](https://github.com/profsmallpine) |[
](https://github.com/IanVS) |[
](https://github.com/Lucklj521) |[
](https://github.com/lucax88x) |[
](https://github.com/lucaperret) |
+[](https://github.com/Jokcy) |[](https://github.com/chromacoma) |[](https://github.com/profsmallpine) |[](https://github.com/IanVS) |[](https://github.com/Lucklj521) |[](https://github.com/lucax88x) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[chromacoma](https://github.com/chromacoma) |[profsmallpine](https://github.com/profsmallpine) |[IanVS](https://github.com/IanVS) |[Lucklj521](https://github.com/Lucklj521) |[lucax88x](https://github.com/lucax88x) |[lucaperret](https://github.com/lucaperret) |
+[Jokcy](https://github.com/Jokcy) |[chromacoma](https://github.com/chromacoma) |[profsmallpine](https://github.com/profsmallpine) |[IanVS](https://github.com/IanVS) |[Lucklj521](https://github.com/Lucklj521) |[lucax88x](https://github.com/lucax88x) |
-[
](https://github.com/ombr) |[
](https://github.com/louim) |[
](https://github.com/dolphinigle) |[
](https://github.com/leomelzer) |[
](https://github.com/leods92) |[
](https://github.com/galli-leo) |
+[](https://github.com/lucaperret) |[](https://github.com/ombr) |[](https://github.com/louim) |[](https://github.com/dolphinigle) |[](https://github.com/leomelzer) |[](https://github.com/leods92) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[ombr](https://github.com/ombr) |[louim](https://github.com/louim) |[dolphinigle](https://github.com/dolphinigle) |[leomelzer](https://github.com/leomelzer) |[leods92](https://github.com/leods92) |[galli-leo](https://github.com/galli-leo) |
+[lucaperret](https://github.com/lucaperret) |[ombr](https://github.com/ombr) |[louim](https://github.com/louim) |[dolphinigle](https://github.com/dolphinigle) |[leomelzer](https://github.com/leomelzer) |[leods92](https://github.com/leods92) |
-[
](https://github.com/dviry) |[
](https://github.com/larowlan) |[
](https://github.com/leaanthony) |[
](https://github.com/hoangbits) |[
](https://github.com/labohkip81) |[
](https://github.com/kyleparisi) |
+[](https://github.com/galli-leo) |[](https://github.com/dviry) |[](https://github.com/larowlan) |[](https://github.com/leaanthony) |[](https://github.com/hoangbits) |[](https://github.com/labohkip81) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[dviry](https://github.com/dviry) |[larowlan](https://github.com/larowlan) |[leaanthony](https://github.com/leaanthony) |[hoangbits](https://github.com/hoangbits) |[labohkip81](https://github.com/labohkip81) |[kyleparisi](https://github.com/kyleparisi) |
+[galli-leo](https://github.com/galli-leo) |[dviry](https://github.com/dviry) |[larowlan](https://github.com/larowlan) |[leaanthony](https://github.com/leaanthony) |[hoangbits](https://github.com/hoangbits) |[labohkip81](https://github.com/labohkip81) |
-[
](https://github.com/elkebab) |[
](https://github.com/kidonng) |[
](https://github.com/kevin-west-10x) |[
](https://github.com/huydod) |[
](https://github.com/HussainAlkhalifah) |[
](https://github.com/HughbertD) |
+[](https://github.com/kyleparisi) |[](https://github.com/elkebab) |[](https://github.com/kidonng) |[](https://github.com/kevin-west-10x) |[](https://github.com/huydod) |[](https://github.com/HussainAlkhalifah) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[elkebab](https://github.com/elkebab) |[kidonng](https://github.com/kidonng) |[kevin-west-10x](https://github.com/kevin-west-10x) |[huydod](https://github.com/huydod) |[HussainAlkhalifah](https://github.com/HussainAlkhalifah) |[HughbertD](https://github.com/HughbertD) |
+[kyleparisi](https://github.com/kyleparisi) |[elkebab](https://github.com/elkebab) |[kidonng](https://github.com/kidonng) |[kevin-west-10x](https://github.com/kevin-west-10x) |[huydod](https://github.com/huydod) |[HussainAlkhalifah](https://github.com/HussainAlkhalifah) |
-[
](https://github.com/hiromi2424) |[
](https://github.com/giacomocerquone) |[
](https://github.com/roenschg) |[
](https://github.com/gjungb) |[
](https://github.com/geoffappleford) |[
](https://github.com/gabiganam) |
+[](https://github.com/HughbertD) |[](https://github.com/hiromi2424) |[](https://github.com/giacomocerquone) |[](https://github.com/roenschg) |[](https://github.com/gjungb) |[](https://github.com/geoffappleford) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[hiromi2424](https://github.com/hiromi2424) |[giacomocerquone](https://github.com/giacomocerquone) |[roenschg](https://github.com/roenschg) |[gjungb](https://github.com/gjungb) |[geoffappleford](https://github.com/geoffappleford) |[gabiganam](https://github.com/gabiganam) |
+[HughbertD](https://github.com/HughbertD) |[hiromi2424](https://github.com/hiromi2424) |[giacomocerquone](https://github.com/giacomocerquone) |[roenschg](https://github.com/roenschg) |[gjungb](https://github.com/gjungb) |[geoffappleford](https://github.com/geoffappleford) |
-[
](https://github.com/fuadscodes) |[
](https://github.com/dtrucs) |[
](https://github.com/ferdiusa) |[
](https://github.com/fgallinari) |[
](https://github.com/Gkleinereva) |[
](https://github.com/epexa) |
+[](https://github.com/gabiganam) |[](https://github.com/fuadscodes) |[](https://github.com/dtrucs) |[](https://github.com/ferdiusa) |[](https://github.com/fgallinari) |[](https://github.com/Gkleinereva) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[fuadscodes](https://github.com/fuadscodes) |[dtrucs](https://github.com/dtrucs) |[ferdiusa](https://github.com/ferdiusa) |[fgallinari](https://github.com/fgallinari) |[Gkleinereva](https://github.com/Gkleinereva) |[epexa](https://github.com/epexa) |
+[gabiganam](https://github.com/gabiganam) |[fuadscodes](https://github.com/fuadscodes) |[dtrucs](https://github.com/dtrucs) |[ferdiusa](https://github.com/ferdiusa) |[fgallinari](https://github.com/fgallinari) |[Gkleinereva](https://github.com/Gkleinereva) |
-[
](https://github.com/EnricoSottile) |[
](https://github.com/elliotdickison) |[
](https://github.com/theJoeBiz) |[
](https://github.com/Jmales) |[
](https://github.com/jessica-coursera) |[
](https://github.com/vith) |
+[](https://github.com/epexa) |[](https://github.com/EnricoSottile) |[](https://github.com/elliotdickison) |[](https://github.com/theJoeBiz) |[](https://github.com/Jmales) |[](https://github.com/jessica-coursera) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[EnricoSottile](https://github.com/EnricoSottile) |[elliotdickison](https://github.com/elliotdickison) |[theJoeBiz](https://github.com/theJoeBiz) |[Jmales](https://github.com/Jmales) |[jessica-coursera](https://github.com/jessica-coursera) |[vith](https://github.com/vith) |
+[epexa](https://github.com/epexa) |[EnricoSottile](https://github.com/EnricoSottile) |[elliotdickison](https://github.com/elliotdickison) |[theJoeBiz](https://github.com/theJoeBiz) |[Jmales](https://github.com/Jmales) |[jessica-coursera](https://github.com/jessica-coursera) |
-[
](https://github.com/janwilts) |[
](https://github.com/janklimo) |[
](https://github.com/jamestiotio) |[
](https://github.com/jcjmcclean) |[
](https://github.com/Jbithell) |[
](https://github.com/JakubHaladej) |
+[](https://github.com/vith) |[](https://github.com/janwilts) |[](https://github.com/janklimo) |[](https://github.com/jamestiotio) |[](https://github.com/jcjmcclean) |[](https://github.com/Jbithell) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[janwilts](https://github.com/janwilts) |[janklimo](https://github.com/janklimo) |[jamestiotio](https://github.com/jamestiotio) |[jcjmcclean](https://github.com/jcjmcclean) |[Jbithell](https://github.com/Jbithell) |[JakubHaladej](https://github.com/JakubHaladej) |
+[vith](https://github.com/vith) |[janwilts](https://github.com/janwilts) |[janklimo](https://github.com/janklimo) |[jamestiotio](https://github.com/jamestiotio) |[jcjmcclean](https://github.com/jcjmcclean) |[Jbithell](https://github.com/Jbithell) |
-[
](https://github.com/jakemcallister) |[
](https://github.com/gaejabong) |[
](https://github.com/JacobMGEvans) |[
](https://github.com/mazoruss) |[
](https://github.com/GreenJimmy) |[
](https://github.com/intenzive) |
+[](https://github.com/JakubHaladej) |[](https://github.com/jakemcallister) |[](https://github.com/gaejabong) |[](https://github.com/JacobMGEvans) |[](https://github.com/mazoruss) |[](https://github.com/GreenJimmy) |
:---: |:---: |:---: |:---: |:---: |:---: |
-[jakemcallister](https://github.com/jakemcallister) |[gaejabong](https://github.com/gaejabong) |[JacobMGEvans](https://github.com/JacobMGEvans) |[mazoruss](https://github.com/mazoruss) |[GreenJimmy](https://github.com/GreenJimmy) |[intenzive](https://github.com/intenzive) |
+[JakubHaladej](https://github.com/JakubHaladej) |[jakemcallister](https://github.com/jakemcallister) |[gaejabong](https://github.com/gaejabong) |[JacobMGEvans](https://github.com/JacobMGEvans) |[mazoruss](https://github.com/mazoruss) |[GreenJimmy](https://github.com/GreenJimmy) |
-[
](https://github.com/NaxYo) |[
](https://github.com/ishendyweb) |
-:---: |:---: |
-[NaxYo](https://github.com/NaxYo) |[ishendyweb](https://github.com/ishendyweb) |
+[](https://github.com/intenzive) |[](https://github.com/NaxYo) |[](https://github.com/ishendyweb) |
+:---: |:---: |:---: |
+[intenzive](https://github.com/intenzive) |[NaxYo](https://github.com/NaxYo) |[ishendyweb](https://github.com/ishendyweb) |
@@ -472,4 +472,3 @@ We use Browserstack for manual testing .
diff --git a/docs/companion.md b/docs/companion.md
new file mode 100644
index 000000000..efd9920c8
--- /dev/null
+++ b/docs/companion.md
@@ -0,0 +1,935 @@
+---
+sidebar_position: 4
+---
+
+# Companion
+
+Companion is an open source server application which **takes away the complexity
+of authentication and the cost of downloading files from remote sources**, such
+as Instagram, Google Drive, and others. Companion is a server-to-server
+orchestrator that streams files from a source to a destination, and files are
+never stored in Companion. Companion can run either as a standalone
+(self-hosted) application, [Transloadit-hosted](#hosted), or plugged in as an
+Express middleware into an existing application. The Uppy client requests remote
+files from Companion, which it will download and simultaneously upload to your
+[Tus server](/docs/tus), [AWS bucket](/docs/aws-s3), or any server that supports
+[PUT, POST or Multipart uploads](/docs/xhr-upload).
+
+This means a user uploading a 5GB video from Google Drive from their phone isn’t
+eating into their data plans and you don’t have to worry about implementing
+OAuth.
+
+## When should I use it?
+
+If you want to let users download files from [Box][], [Dropbox][], [Facebook][],
+[Google Drive][googledrive], [Instagram][], [OneDrive][], [Unsplash][], [Import
+from URL][url], or [Zoom][] — you need Companion.
+
+Companion supports the same [uploaders](/docs/guides/choosing-uploader) as Uppy:
+[Tus](/docs/tus), [AWS S3](/docs/aws-s3), and [regular multipart](/docs/tus).
+But instead of manually setting a plugin, Uppy sends along a header with the
+uploader and Companion will use the same on the server. This means if you are
+using [Tus](/docs/tus) for your local uploads, you can send your remote uploads
+to the same Tus server (and likewise for your AWS S3 bucket).
+
+:::note
+
+Companion only deals with _remote_ files, _local_ files are still uploaded from
+the client with your upload plugin.
+
+:::
+
+## Hosted
+
+Using [Transloadit][] services comes with a hosted version of Companion so you
+don’t have to worry about hosting your own server. Whether you are on a free or
+paid Transloadit [plan](https://transloadit.com/pricing/), you can use
+Companion. It’s not possible to rent a Companion server without a Transloadit
+plan.
+
+[**Sign-up for a (free) plan**](https://transloadit.com/pricing/).
+
+:::tip
+
+Choosing Transloadit for your file services also comes with credentials for all
+remote providers. This means you don’t have to waste time going through the
+approval process of every app. You can still add your own credentials in the
+Transloadit admin page if you want.
+
+:::
+
+:::info
+
+Downloading and uploading files through Companion doesn’t count towards your
+[monthly quota](https://transloadit.com/docs/faq/1gb-worth/), it’s a way for
+files to arrive at Transloadit servers, much like Uppy.
+
+:::
+
+## Installation & use
+
+Companion is installed from npm. Depending on how you want to run Companion, the
+install process is slightly different. Companion can be integrated as middleware
+into your [Express](https://expressjs.com/) app or as a standalone server. Most
+people probably want to run it as a standalone server, while the middleware
+could be used to further customise Companion or integrate it into your own HTTP
+server code.
+
+:::note
+
+Since v2, you need to be running `node.js >= v10.20.1` to use Companion. More
+information in the
+[migrating to 2.0](/docs/guides/migration-guides/#migrate-from-uppy-1x-to-2x)
+guide.
+
+Windows is not a supported platform right now. It may work, and we’re happy to
+accept improvements in this area, but we can’t provide support.
+
+:::
+
+### Standalone mode
+
+You can use the standalone version if you want to run Companion as it’s own
+Node.js process. It’s a configured Express server with sessions, logging, and
+security best practices. First you’ll typically want to install it globally:
+
+```bash
+npm install -g @uppy/companion
+```
+
+Standalone Companion will always serve HTTP (not HTTPS) and expects a reverse
+proxy with SSL termination in front of it when running in production. See
+[`COMPANION_PROTOCOL`](#server) for more information.
+
+Companion ships with an executable file (`bin/companion`) which is the
+standalone server. Unlike the middleware version, options are set via
+environment variables.
+
+:::info
+
+Checkout [options](#options) for the available options in JS and environment
+variable formats.
+
+:::
+
+You need at least these three to get started:
+
+```bash
+export COMPANION_SECRET="shh!Issa Secret!"
+export COMPANION_DOMAIN="YOUR SERVER DOMAIN"
+export COMPANION_DATADIR="PATH/TO/DOWNLOAD/DIRECTORY"
+```
+
+Then run:
+
+```bash
+companion
+```
+
+You can also pass in the path to your JSON config file, like so:
+
+```bash
+companion --config /path/to/companion.json
+```
+
+You may also want to run Companion in a process manager like
+[PM2](https://pm2.keymetrics.io/) to make sure it gets restarted on upon
+crashing as well as allowing scaling to many instances.
+
+### Express middleware mode
+
+First install it into your Node.js project with your favorite package manager:
+
+```bash
+npm install @uppy/companion
+```
+
+To plug Companion into an existing server, call its `.app` method, passing in an
+[options](#options) object as a parameter. This returns a server instance that
+you can mount on a route in your Express app.
+
+```js
+import express from 'express';
+import bodyParser from 'body-parser';
+import session from 'express-session';
+import companion from '@uppy/companion';
+
+const app = express();
+
+// Companion requires body-parser and express-session middleware.
+// You can add it like this if you use those throughout your app.
+//
+// If you are using something else in your app, you can add these
+// middlewares in the same subpath as Companion instead.
+app.use(bodyParser.json());
+app.use(session({ secret: 'some secrety secret' }));
+
+const companionOptions = {
+ providerOptions: {
+ drive: {
+ key: 'GOOGLE_DRIVE_KEY',
+ secret: 'GOOGLE_DRIVE_SECRET',
+ },
+ },
+ server: {
+ host: 'localhost:3020',
+ protocol: 'http',
+ // Default installations normally don't need a path.
+ // However if you specify a `path`, you MUST specify
+ // the same path in `app.use()` below,
+ // e.g. app.use('/companion', companionApp)
+ // path: '/companion',
+ },
+ filePath: '/path/to/folder/',
+};
+
+const { app: companionApp } = companion.app(companionOptions);
+app.use(companionApp);
+```
+
+Companion uses WebSockets to communicate progress, errors, and successes to the
+client. This is what Uppy listens to to update it’s internal state and UI.
+
+Add the Companion WebSocket server using the `companion.socket` function:
+
+```js
+const server = app.listen(PORT);
+
+companion.socket(server);
+```
+
+If WebSockets fail for some reason Uppy and Companion will fallback to HTTP
+polling.
+
+### Running many instances
+
+We recommend running at least two instances in production, so that if the
+Node.js event loop gets blocked by one or more requests (due to a bug or spike
+in traffic), it doesn’t also block or slow down all other requests as well (as
+Node.js is single threaded).
+
+As an example for scale, one enterprise customer of Transloadit, who self-hosts
+Companion to power an education service that is used by many universities
+globally, deploys 7 Companion instances. Their earlier solution ran on 35
+instances. In our general experience Companion will saturate network interface
+cards before other resources on commodity virtual servers (`c5d.2xlarge` for
+instance).
+
+Your mileage may vary, so we recommend to add observability. You can let
+Prometheus crawl the `/metrics` endpoint and graph that with Grafana for
+instance.
+
+#### Using unique endpoints
+
+One option is to run many instances with each instance having its own unique
+endpoint. This could be on separate ports, (sub)domain names, or IPs. With this
+setup, you can either:
+
+1. Implement your own logic that will direct each upload to a specific Companion
+ endpoint by setting the `companionUrl` option
+2. Setting the Companion option `COMPANION_SELF_ENDPOINT`. This option will
+ cause Companion to respond with a `i-am` HTTP header containing the value
+ from `COMPANION_SELF_ENDPOINT`. When Uppy’s sees this header, it will pin all
+ requests for the upload to this endpoint.
+
+In either case, you would then also typically configure a single Companion
+instance (one endpoint) to handle all OAuth authentication requests, so that you
+only need to specify a single OAuth callback URL. See also `oauthDomain` and
+`validHosts`.
+
+#### Using a load balancer
+
+The other option is to set up a load balancer in front of many Companion
+instances. Then Uppy will only see a single endpoint and send all requests to
+the associated load balancer, which will then distribute them between Companion
+instances. The companion instances coordinate their messages and events over
+Redis so that any instance can serve the client’s requests. Note that sticky
+sessions are **not** needed with this setup. Here are the requirements for this
+setup:
+
+* The instances need to be connected to the same Redis server.
+* You need to set `COMPANION_SECRET` to the same value on both servers.
+* if you use the `companionKeysParams` feature (Transloadit), you also need
+ `COMPANION_PREAUTH_SECRET` to be the same on each instance.
+* All other configuration needs to be the same, except if you’re running many
+ instances on the same machine, then `COMPANION_PORT` should be different for
+ each instance.
+
+## API
+
+### Options
+
+:::tip
+
+The headings display the JS and environment variable options (`option`
+`ENV_OPTION`). When integrating Companion into your own server, you pass the
+options to `companion.app()`. If you are using the standalone version, you
+configure Companion using environment variables. Some options only exist as
+environment variables or only as a JS option.
+
+:::
+
+