Posted on • Originally published at on

Oasis - A Super Basic Self Hosted File Server

Oasis - A Super Basic Self Hosted File Server

File server apps are a dime a dozen these days but it never hurts to have more. Each app has different options that suit different needs for people. Oasis is one of those file indexing apps that's right there in the middle. It's not too complex yet it has just enough features you'd expect to see from a basic file server.

What is Oasis file Server

Oasis is a self hosted file server written in Rust. It has a simple web interface for frustration free file management allowing you to view, download, upload and share files on your server.

Oasis - A Super Basic Self Hosted File Server

Oasis core Features

  • User authentication
  • File preview
  • File download
  • File upload
  • Play list
  • Mobile compatibility
  • External link
  • Third-party media player support via external link
  • Multiple platform support (Linux, MacOS, Windows, Docker)
  • I18n (English, Chinese)
  • Docker Image

Install Oasis File Server using Docker Compose

This simple Docker Compose can have you up and running in no time! Just edit the values as needed below.

version: '3.3'
        container_name: oasis
            - '/docker/oasis/data:/opt/oasis/data'
            - '/docker/oasis/storage:/home/storage'
            - '8000:8000'
        image: machengim/oasis

Enter fullscreen mode Exit fullscreen mode

Oasis File Server Setup

Browse to the IP and port where you installed Oasis and you will be presented with the simple setup screen. Since Oasis uses SQLite, you won't have to worry about any database settings.


Enter a username and password for the admin credentials then choose your storage location. I will select the storage location I mapped in the Docker Compose file. This is where our files and folders will be placed when we add them from the Oasis web interface.

Oasis - A Super Basic Self Hosted File Server

When you log in for the first time, you can click the user icon in the top right corner to open the menu. From there you can change the Oasis settings. It's important to note that you can enable guest access from here.

Oasis - A Super Basic Self Hosted File Server

If you enable guest view, the only way for guests to view the files is to go to the main page and click "Guest login". File and folder links cannot be viewed directly as a guest until after the Guest login button is pressed.


Like what you see? Consider subscribing to the Noted newsletter and never miss a beat! You can always unsubscribe at any time.

Uploading files with Oasis

One thing I wanted to make clear is that you cannot upload folders with files in them. You can only upload individual files as it stands.

To upload files, you can click the blue "New" button on the top right side. From here you can create folders too. I created 4 folders for different file types. From here you can go into the folder where you want to upload and press the blue "New" button again to upload to that folder.


When the uploads begin, you can see a nice progress menu showing you what files are uploading on the bottom right side of the screen.

Viewing files with Oasis

File viewing is where Oasis shines the most. You can see the examples here that show each file view within the Oasis web interface. For the most part, file views appear to be relatively basic and simple.

Oasis Photo View

Photos are shown in a basic view with no information or exif data displayed.

Oasis - A Super Basic Self Hosted File Server

Oasis Music Player View

Music can be streamed within Oasis. There is a cog wheel that allows you to change the speed of the audio being played. This feature might be good for podcasts. You can also see the file playlist on the right side showing all the music in that folder.

Oasis - A Super Basic Self Hosted File Server

Oasis Text file View

Text file view has much to be desired. You cannot edit the file and there is no word wrap making it tedious to scroll right to read the file.

Oasis - A Super Basic Self Hosted File Server

Oasis PDF view

PDF files are embedded into the interface allowing you to read them at a click.

Oasis - A Super Basic Self Hosted File Server

Sharing Files with Oasis

Currently, only files can be shared and downloaded. Folders cannot be shared or downloaded but I believe it is on the roadmap ahead by the looks of it.

Oasis - A Super Basic Self Hosted File Server

To share a direct link to a file, you have to browse to the file and click the link icon at the top.


It will place a 6 hour limit on the file share that currently cannot be changed. So you are very limited on how you can share files using Oasis and it appears the app was built more around personal use rather than public file sharing. Perhaps in the roadmap ahead, that may change 😀

Downloading files as a Guest viewer is a bit tricky. The only way to do it is to browse to the file and click the link icon at the top which is kind of obscure. There's no control over what Guests can download other than a hide feature the admin can place on files they don't want guests to see or download.

Oasis - A Super Basic Self Hosted File Server
Tap the image and rotate your device sideways for larger view.

Oasis File Management

Or the lack thereof. Oasis is great for viewing files but when it comes to managing or editing files, you are very limited.


You can rename, copy, move and delete files by right clicking on the file you want to manage. However, you cannot edit text files from the web interface.


Join us on Hosted - A Self Hosted and Homelab discussion forum!

Final Notes and Thoughts

Oasis file server is great for viewing files such as photos, documents and audio files. When it comes to sharing files publicly or editing text files, it leaves much to be desired. Like we stated earlier, the roadmap shows more to come! So perhaps we will see these small concerns added in the near future.

If you are on the lookout for a basic file host, Oasis might do the trick. Be sure to swing by the Oasis file server Github page and give it a star!

Top comments (0)