HomeFusionOS is an open-source, web-based system designed to manage and monitor Docker containers, file storage, user access, and system resources. It’s being developed as a comprehensive operating system for home server setups, offering an easy-to-use interface to control and manage various services and applications.
Now running smoothly on a custom Ubuntu Server 22.04.05 LTS image tailored for performance and simplicity.
- User Authentication: Secure login and account management for multiple users.
- Docker Management: Easily install and manage Docker applications.
- File Management: Upload, organize, and manage your files and folders.
- System Monitoring: View real-time statistics on CPU, RAM, and network usage.
- Access to Command Shell: Real-time terminal access for advanced operations.
- Good Interface: A clean and user-friendly dashboard.
- Custom OS Compatibility: Optimized to run out-of-the-box on a custom Ubuntu environment.
- Nextcloud
Personal cloud platform for file sync and sharing.
Docker Image:nextcloud
Port: 8003
- Pi-hole
Network-wide ad blocker.
Docker Image:pihole/pihole
Port: 8006
- Jellyfin
Open-source media server for streaming movies, TV shows, and music.
Docker Image:jellyfin/jellyfin
Port: 8022
- Home Assistant
Home automation platform for managing smart devices.
Docker Image:ghcr.io/home-assistant/home-assistant:stable
Port: 8123
- code-server
Visual Studio Code in the browser for remote development.
Docker Image:linuxserver/code-server
Port: 8011 - Gitea
Self-hosted Git service for managing code repositories.
Docker Image:gitea/gitea
Port: 8012
- Calibre Web
Web-based ebook management and reading interface.
Docker Image:linuxserver/calibre-web
Port: 8018
- Firefox
Mozilla Firefox browser running in a container.
Docker Image:jlesage/firefox
Port: 8020 - Tor Browser
Anonymous browsing with Tor.
Docker Image:domistyle/tor-browser
Port: 5800
- WordPress
Content management system for creating websites and blogs.
Docker Image:wordpress
Port: 8023
HomeFusionOS aims to evolve into a fully-featured operating system for building and managing home servers. It will provide users with a seamless experience for running a wide variety of services by networks. The goal is to offer easy setup and management for different applications, whether for file sharing, media streaming, automation, development, or more, with a clean design, making it the ideal platform for home server enthusiasts.
HomeFusionOS is designed to run on your local system or a dedicated machine. It has been tested and runs smoothly on a custom Ubuntu-based OS (22.04.05 LTS).
-
Clone the repository:
git clone https://github.com/pedrolucas7i/HomeFusionOS.git cd HomeFusionOS -
Install dependencies:
pip install -r requirements.txt
-
Copy the
.env.exampleto.envand set up environment variables:SECRET_KEY=<your-secret-key> -
Start the app:
python app.py
-
Access the app at
http://localhost:9900.
After installing HomeFusionOS, access the dashboard using the default credentials below:
- User:
admin - Password:
adminpassword
Be sure to change this after your first login for security reasons.
For best performance and compatibility, you can install HomeFusionOS on our computer, the image is based on Ubuntu Server 22.04.05 LTS.
🖥️ Features of the custom image:
- Operating system installer
- Pre-installed Python 3 and required system packages
- Docker and Docker Compose configured
- Optimized network and disk settings for home server use
- Ready to run HomeFusionOS out of the box
📦 Download HomeFusionOS-2025.04.20:
Download from Google Drive
💡 Installation tips:
- Use tools like Rufus or balenaEtcher to flash the image onto a USB drive.
- Boot your server or VM with the image.
- Log in, pull the HomeFusionOS repository, and start the app as described above.
MIT License - see the LICENSE file for details.
- Pedro Lucas (pedrolucas7i)
With ❤️, HomeFusionOS is your future-proof solution for home server management. Whether you're managing storage, media, or development tools, HomeFusionOS has got your back!