surfer

surfer

Name Last Update
cli Loading commit data...
frontend Loading commit data...
screenshots Loading commit data...
src Loading commit data...
test Loading commit data...
.dockerignore Loading commit data...
.gitignore Loading commit data...
.jshintrc Loading commit data...
CHANGELOG Loading commit data...
CloudronManifest.json Loading commit data...
DESCRIPTION.md Loading commit data...
Dockerfile Loading commit data...
LICENSE.md Loading commit data...
POSTINSTALL.md Loading commit data...
README.md Loading commit data...
admin Loading commit data...
logo.png Loading commit data...
npm-shrinkwrap.json Loading commit data...
package.json Loading commit data...
server.js Loading commit data...
start.sh Loading commit data...

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

Install

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.

git clone https://git.cloudron.io/cloudron/surfer.git
cd surfer
cloudron build
cloudron install

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 <public folder>

Use the admin tool to manage local users.

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