Mikochi

Mikochi is a minimalist remote file browser designed for self-hosted servers and NAS devices. It provides a lightweight Go API backend and a Preact/JavaScript web UI to browse, manage, download and stream files to external players.

Key Features

• Browse remote folders and view file metadata from a simple web UI
• Fuzzy filename search for quick file discovery
• Upload files, create folders, rename and delete items
• Download files and directories (directories are archived as .tar.gz)
• Stream media files to external players such as VLC or MPV via stream endpoints
• Simple authentication using environment-configured username/password and JWT; option to disable auth
• Multiple deployment options: single binary, Docker container, Helm chart for Kubernetes
• Small, opinionated feature set focused on low resource usage and ease of deployment

Use Cases

• Provide web-based access to files on a home NAS or self-hosted server
• Stream media to local players without a dedicated media server
• Share/upload files with trusted users in small deployments where complex permissions are unnecessary

Limitations and Considerations

• Authentication is basic (single username/password via environment variables); no built-in multi-user or role-based access control
• Lacks advanced permissioning, external identity provider integrations, or per-user isolation
• Search is filename-based (not full-text); large directories or heavy concurrent transfers may affect performance
• Directory downloads are provided as tar.gz archives only

Mikochi is best suited for users who need a small, easy-to-deploy file browser and simple media streaming on self-hosted infrastructure. It favors simplicity and minimal resource usage over enterprise features.