Neanderthals Programming Machines
Have ideas to improve npm?Join in the discussion! »

cloudron-surfer

5.13.5-1 • Public • Published

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
npm run build
./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

Development

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

During UI development, the assets have to be built after changes. This can be done automatically with

npm run watch

While having the ./server.js instance running.

Keywords

Install

npm i cloudron-surfer

DownloadsWeekly Downloads

100

Version

5.13.5-1

License

MIT

Unpacked Size

1.35 MB

Total Files

64

Last publish

Collaborators

  • avatar
  • avatar