Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cloudron-io/surfer
Simple static file server with cli and webinterface. This is just a mirror repo
https://github.com/cloudron-io/surfer
Last synced: 5 days ago
JSON representation
Simple static file server with cli and webinterface. This is just a mirror repo
- Host: GitHub
- URL: https://github.com/cloudron-io/surfer
- Owner: cloudron-io
- License: mit
- Created: 2016-11-16T16:49:07.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-10-29T10:17:23.000Z (10 days ago)
- Last Synced: 2024-10-29T12:18:41.005Z (10 days ago)
- Language: JavaScript
- Homepage: https://git.cloudron.io/cloudron/surfer
- Size: 4.87 MB
- Stars: 57
- Watchers: 6
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-starred - cloudron-io/surfer - Simple static file server with cli and webinterface. This is just a mirror repo (others)
README
# 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
[](https://cloudron.io/button.html?app=io.cloudron.surfer)
or using the [Cloudron command line tooling](https://docs.cloudron.io/packaging/cli/)
```bash
cloudron install --appstore-id io.cloudron.surfer
```
## Building
### Cloudron
The app package can be built using the [Cloudron command line tooling](https://docs.cloudron.io/packaging/cli/).
```bash
git clone https://git.cloudron.io/cloudron/surfer.git
cd surfer
cloudron build
cloudron install
```
## 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.
```bash
npm -g install cloudron-surfer
```
Configure cli using your app domain and an API token created via the surfer admin user interface:
```bash
surfer config --server --token
```
Put some files:
```bash
surfer put [file]
```
## Development
```bash
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 with
```bash
npm run build
```
While having the `./server.js` instance running.