Skip to content

machengim/oasis

Repository files navigation

OASIS

Build License: MIT GitHub release (latest SemVer) Docker

中文 README

A self-hosted file server.

Install

  1. Download from the release page
  2. Uncompress
  3. Grant execute permission to oasis file if running in Linux or MacOS
  4. (Optional) Config server IP and port number in oasis.conf file
  5. Run oasis or oasis.exe
  6. Visit the server's IP address in your favorite browser

Docker

https://hub.docker.com/r/machengim/oasis

docker run --name oasis -t -d \
-v <data>:/opt/oasis/data \
-v <storage>:/home/storage \
-p <port>:8000 machengim/oasis

Build

  • Node 14+
  • Rust 1.54+
cd path/to/oasis
node build.js

Features

  • User authentication
  • File preview/download/upload/Search
  • Media file play list
  • File external link
  • I18n (English, Chinese)

File format support

  • Text
  • Image (browser support)
  • Audio (browser support)
  • Video (browser support)
  • Subtitle (srt / vtt format, supported in Chrome, Firefox and Edge by now)
  • PDF (supported by pdf.js)

Tech stack

Credits