Hironico's nico.drive is a webdav server running on nodejs. It features full support of WebDAV protocol plus additional exclusive features to ease display and search of hosted files. To take full advantage of the additional APIs, the server comes with its own web application embbedded (aka the nico.drive.client project).
It's an all-in-one solution to backup important files and memories yet very simple to install and use.
- WebDAV compliant server compatible with all WebDav enabled devices such as NAS (Synology, QNap etc...)
- Out of the box ready to run but also highly configurable (see dotenv-sample file)
- Additional features as additional REST api :
- image thumbnail generator
- image metadata API support for EXIF and XMP
- digital camera raw file formats support for thumbs
- Embedded WebDAV explorer web application
In order to get it up and running in your environment, you need :
- A server box : private cloud or dedicated machine, the choice is yours. For instance, we use a Linux dedicated box.
- An SSL certificate (with its key). Self signed for development/testing or use Let's Encrypt for production.
Assuming you have configured your box with a dedicated user ; to run your server, then you need to:
-
Git clone the repository
-
COPY the "dotenv-sample" file into a file named ".env", then adapt to reflect your current setup.
-
npm install
-
npm run build
-
npm run start
-
Connect WebDav client to your new server (follow vendor instructions)
or
Point you browser at the root url of your server (see .env file for setup)
The configuration is splitted into two parts:
- server config : network ports, certificates ...
- user config : user access and root directories for each user
Each configuration has examples in a dedicated sample file that can be customized. See below.
COPY the dotenv.sample file to create a file named '.env' (dot env litterally).
IMPORTANT: Never expose the .env in your webserver in any way.
Then you can customize the .env file to suit your needs.
COPY the user_config.json.default into a file named users_config.json
Assign each user one or more root directories for storing/sharing files from/to your server.
Users can have the following roles:
- all : user is admin user for this root directory. Not only it has write access but also can create shares to existing other users.
- canRead : readonly access
- CanWrite: read and write access but not possible to create shares.
The following is developper instructions about the way Nico's Drive has been built. Is contains various links where the author found instructions on how to setup teh development environment, code, libraries used etc...
- Namespace 'serveStatic' has no exported member 'RequestHandlerConstructor
See : DefinitelyTyped/DefinitelyTyped#49595
Run th efollowing commands to solve:
- npm update @types/express-serve-static-core --depth 2
- npm update @types/serve-static --depth 2
- In order to setup the project we used a slightly updated version of the tutorial available here at okta
- tslint being outdated, we used eslint instead with instructions here Getting started with eslint
- In order to get HTTPS working we followed the following tutorial: Running ExpressJS server over HTTPS
- After that we needed configuration options: so we use the dotEnv project
- Created the azure-pipelines.yml to get continuous integration from Azure DevOps
- Thumbnail library is SHARP
- Original Digital Camera RAW file support from dcraw : https://www.dechifro.org/dcraw/
- Advanced Digital Camera RAW file support provided via LibRaw