Simple static file server with cli and webinterface
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.dockerignore
.gitignore
.jshintrc
README.md

README.md

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.

!!WARNING this repo has moved to https://git.cloudron.io/cloudron/surfer

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