🌐 RClone Manager Headless
Run RClone Manager as a web server on any Linux machine
Perfect for servers, NAS devices, and remote systems
---
## 📖 Introduction
**RClone Manager Headless** brings the full power of the desktop application to your browser. It is designed for:
- **Linux Servers & VPS**
- **NAS Devices** (Unraid, Synology, TrueNAS)
- **Docker Environments**
### ⚠️ Architecture Note (Tauri + Xvfb)
This is a **headless desktop application**, not a native web server. It uses **Xvfb** (Virtual Framebuffer) to run the GUI in the background and streams the interface to your browser.
- **Docker:** Handles all dependencies automatically (Recommended).
- **Binary:** Requires `xvfb`, `gtk3`, and `webkit2gtk` installed on your system.
---
## 🚀 Quick Start (Docker)
The easiest way to run the application.
```bash
docker run -d \
--name rclone-manager \
--restart=unless-stopped \
-p 8080:8080 \
-p 53682:53682 \
-v rclone-config:/home/rclone-manager/.config/rclone \
-v rclone-manager-data:/home/rclone-manager/.local/share/com.rclone.manager.headless \
ghcr.io/zarestia-dev/rclone-manager:latest
```
- **Web UI:** `http://YOUR_IP:8080`
- **OAuth Redirect:** Port `53682` (Required for Google Drive/OneDrive auth).
> 🔐 **Need Authentication or HTTPS?**
> Check the **[Configuration Guide](https://github.com/Zarestia-Dev/rclone-manager/wiki/Configuration-Headless)** for enabling password protection and TLS.
---
## 📦 Downloads
| Repository | Version | Install Command |
| :------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **AUR** | [](https://aur.archlinux.org/packages/rclone-manager-headless) | `yay -S rclone-manager-headless` |
| **Direct Download** | [](https://github.com/Zarestia-Dev/rclone-manager/releases/tag/headless-v0.1.9) | 
|
| **GitHub Packages (GHCR)** | 
| `docker pull ghcr.io/zarestia-dev/rclone-manager:latest` |
---
## 🆚 Desktop vs Headless
| Feature | Desktop App | Headless Server |
| :----------------- | :------------ | :----------------------- |
| **Interface** | Native Window | Web Browser |
| **Remote Control** | Local Only | ✅ Network Accessible |
| **Authentication** | System User | ✅ Built-in (Basic Auth) |
| **Auto-Updates** | ✅ Yes | ✅ Yes (via Docker Pull) |
---
## 🔗 Resources
- 📚 **[Documentation Wiki](https://github.com/Zarestia-Dev/rclone-manager/wiki)**
- 🐛 **[Report a Bug](https://github.com/Zarestia-Dev/rclone-manager/issues)**
- 💬 **[Discussions](https://github.com/Zarestia-Dev/rclone-manager/discussions)**
Made with ❤️ by the Zarestia Dev Team