update-manager/README.md
2026-03-18 16:13:32 +01:00

143 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🖥️ Update Manager
Simple CLI tool to check and manage updates across multiple Ubuntu systems over SSH.
Built for Lanx environments lightweight, fast and no unnecessary dependencies.
---
## 🚀 Features
* Check updates on multiple hosts
* Run updates remotely over SSH
* Simple config files
* No agents required
* Works with existing SSH setup
---
## 🖥️ Update Manager UI
<p align="center">
<img src="update-manager-ui.png" width="50%" alt="Update Manager CLI UI">
</p>
<p align="center">
<em>Lightweight • No dependencies • Works over SSH</em>
</p>
---
## ⚡ Quick Install (1-minute setup)
```bash
git clone https://github.com/YOUR-USER/update-manager.git
cd update-manager
sudo mkdir -p /opt/update-manager
sudo cp update-manager.sh /opt/update-manager/
sudo chmod +x /opt/update-manager/update-manager.sh
sudo ln -s /opt/update-manager/update-manager.sh /usr/local/bin/update-manager
```
---
## ⚙️ Configuration
### 1. Copy config files
```bash
cp update-manager.conf.example update-manager.conf
cp hosts.conf.example hosts.conf
```
---
### 2. Edit hosts
```bash
nano hosts.conf
```
Example:
```bash
# name ip user
server1 192.168.1.10 user
server2 192.168.1.20 user
server3 192.168.1.30 user
```
---
## ▶️ Usage
### Check updates
```bash
update-manager check
```
---
### Run updates
```bash
update-manager update
```
---
## 📁 File Structure
```
/opt/update-manager/
├── update-manager.sh
├── update-manager.conf
├── hosts.conf
```
---
## 🧠 How it works
* Uses SSH to connect to each host
* Runs `apt` commands remotely
* No agents or services needed
* Designed for small to medium setups
---
## 🔐 Requirements
* SSH access to all hosts
* SSH keys recommended (no password prompts)
* Ubuntu/Debian-based systems
---
## 🧩 Future ideas
* Ntfy messages
* Web interface
* Email reporting
* Log files
* Monitoring
* Plugins
* Security / compliance
* AI integration
---
## 🦊 Author
Built with ❤️ for Lanx by **NodeFox*** and **Eddie**
---
## 📜 License
This project is licensed under the GNU GPL v3 License.
You are free to use, modify and distribute this software under the same license.