Surfer

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

or using the Cloudron command line tooling

cloudron install --appstore-id io.cloudron.surfer

Building

Cloudron

The app package can be built using the Cloudron command line tooling.

cd surfer

cloudron build
cloudron install

Standalone

Surfer can also be run standlone on any server:

git clone https://github.com/nebulade/surfer.git
cd surfer
npm install
./app.js <public folder>

Without LDAP integration, the default username is test with the same password. Check src/auth.js for further details about user management.

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

Login using your Cloudron credentials:

surfer login <this app's url>

Put some files:

surfer put [file]

Testing

The e2e tests are located in the test/ folder and require nodejs. 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

npm install
USERNAME=<cloudron username> PASSWORD=<cloudron password> mocha --bail test/test.js