X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=README.md;h=e4061dfe87b3017cf22b3ba0029f888d550b1491;hb=83544c5c8685db63b98d8035b99c501afe509776;hp=cee5e0588e922f4af9e0397f287c4e90a3c701e4;hpb=ebd7ed7a5a93ea8b55addef0175fc777f400b954;p=perso%2FImmae%2FProjets%2FNodejs%2FSurfer.git diff --git a/README.md b/README.md index cee5e05..e4061df 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # Surfer -Surfer is a Simple static file server. It comes with a commandline tool -to upload files from your local folders. +Surfer is a Simple static file server. +It comes with a commandline tool to upload files from your local folders and a webinterface to manage files directly on the server. ## Installation @@ -15,41 +15,52 @@ cloudron install --appstore-id io.cloudron.surfer ## Building +### Cloudron The app package can be built using the [Cloudron command line tooling](https://cloudron.io/references/cli.html). ``` +git clone https://git.cloudron.io/cloudron/surfer.git cd surfer - cloudron build cloudron install ``` -### How to upload - -You can upload files using the commandline tool. +### Standalone +Surfer can also be run standlone on any server: +``` +git clone https://git.cloudron.io/cloudron/surfer.git +cd surfer +npm install +./server.js +``` +Use the `admin` tool to manage local users. -First, install the surfer cli tool using npm. +## File management - sudo npm -g install cloudron-surfer +The admin interface is available under the `/_admin` location or you can upload files using the commandline tool. +First, install the surfer cli tool using npm. +``` +npm -g install cloudron-surfer +``` Login using your Cloudron credentials: - - surfer login - +``` +surfer login +``` Put some files: +``` +surfer put [file] +``` - surfer put [file] - ## Testing The e2e tests are located in the `test/` folder and require [nodejs](http://nodejs.org/). They are creating a fresh build, install the app on your Cloudron, perform tests, backup, restore and test if the files are still ok. ``` -cd surfer/test +cd surfer npm install -USERNAME= PASSWORD= mocha --bail test.js +USERNAME= PASSWORD= mocha --bail test/test.js ``` -