X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;ds=sidebyside;f=README.md;h=ec1c108bd9df07e6c9902d39771e8d87045903e1;hb=3f030be1aae8f238bc07fd749af2e86ab5ba55c6;hp=b9402584f41d8255d5e12d700a0d3fc4fe1159cf;hpb=d56e255fb4aa98ca7dce339bd0acba361e541d40;p=perso%2FImmae%2FProjets%2FNodejs%2FSurfer.git diff --git a/README.md b/README.md index b940258..ec1c108 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,6 +15,7 @@ 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). ``` @@ -24,21 +25,43 @@ cloudron build cloudron install ``` -### How to upload +### Standalone +Surfer can also be run standlone on any server: +``` +git clone https://github.com/nebulade/surfer.git +cd surfer +npm install +./app.js +``` +Without LDAP integration, the default username is `test` with the same password. Check `src/auth.js` for further details about user management. -You can upload files using the commandline tool. +## File management + +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 +``` - sudo npm -g install cloudron-surfer +Login using your Cloudron credentials: +``` +surfer login +``` +Put some files: +``` +surfer put [file] +``` -Login using your Cloudron credentials: +## Testing - surfer login +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 -Put some files: +npm install +USERNAME= PASSWORD= mocha --bail test/test.js +``` - surfer put [file] -