selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
Mikochi logo

Self-host Mikochi

1.12.2

Minimalist remote file browser with streaming

ReleaseOpen SourceMIT
Updated8 hours ago
LanguageJavaScript
Setup difficultyEasy
Stars
378
Port
80 (HTTP web interface)
Docker
zer0tonin/mikochi
Install with Docker
Mikochi web interface showing file browser

What is Mikochi?

Mikochi is a lightweight remote file browser for self-hosted servers and NAS devices. It provides a web UI to explore remote folders, upload and create files and directories, rename and remove items, download files and folders as tar.gz archives, and create streaming links that work with VLC or mpv. The frontend uses Preact and the backend uses Go with Gin. You can deploy it via Docker, a Kubernetes Helm chart, Debian/Ubuntu .deb packages, Fedora/RHEL .rpm packages, or a pre-compiled binary. Configuration relies on environment variables for the data directory, login credentials, TLS certificates, and the listening address. Authentication uses a single username/password pair with JWT tokens; there is no built-in LDAP, OIDC, or SAML support. The project is MIT licensed.

Should you self-host Mikochi?

Mikochi scores 50/100 on selfhost.directory (how scoring works) and ranks #18 of 34 in File Management. It has 378 GitHub stars.

It shipped 11 stable releases in the past year. The latest, 1.12.2, came out on 15 October 2026. New versions land roughly every 5 days.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is MIT-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is AList (83/100, 50 365 stars). It scores higher overall, so compare the two before you pick. See Mikochi vs AList side by side.

Features

  • ARM Support
  • Debian/Ubuntu package
  • File Browsing
  • File Download
  • File rename and delete
  • File Upload
  • Fuzzy Search
  • Gzip compression
  • High-performance backend
  • Media streaming
  • No-auth modeOnly recommended for private networks
  • RPM package
  • TLS/HTTPS Support
  • Web Interface

Mikochi README

How to install Mikochi

Install Mikochi with Docker

Docker
Environment variables
DATA_DIR, USERNAME, PASSWORD, HOST, JWT_SECRET, CERT_CA, CERT_KEY, NO_AUTH, GZIP, FRONTEND_FILES

docker run
-p 8080:8080 -v $(PWD)/data:/data
-e DATA_DIR="/data" -e USERNAME=zer0tonin
-e PASSWORD=horsebatterysomething zer0tonin/mikochi:latest

Mount a data directory and set username/password via environment variables

How to configure Mikochi

  • CERT_CAThe path to a TLS certificate

    The path to a TLS certificate

  • CERT_KEYThe path to the key associated with CERT_CA

    The path to the key associated with CERT_CA

  • DATA_DIR/dataThe directory accessed by Mikochi

    The directory accessed by Mikochi

  • FRONTEND_FILES/usr/share/mikochi/staticThe location of the frontend static files

    The location of the frontend static files

  • GZIPfalseIf true, enables gzip compression

    If true, enables gzip compression

  • HOST0.0.0.0:80The ip:port Mikochi will listen on

    The ip:port Mikochi will listen on

  • JWT_SECRET[Random]A secret string for JWT validation (see warning)

    A secret string for JWT validation (see warning)

  • NO_AUTHfalseIf true, disables all authentication

    If true, disables all authentication

  • PASSWORDpassThe password for login

    The password for login

  • USERNAMErootThe username for login

    The username for login

Mikochi releases & version history

More in File Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…