update-manager/README.md
2026-03-18 16:19:25 +01:00

147 lines
2.3 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.
---
## 📚 Table of Contents
* [Features](#features)
* [Update Manager UI](#update-manager-ui)
* [Quick Install](#quick-install)
* [Configuration](#configuration)
* [Usage](#usage)
* [File Structure](#file-structure)
* [How it works](#how-it-works)
* [Requirements](#requirements)
* [Future ideas](#future-ideas)
* [License](#license)
---
## 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
```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
### Copy config files
```bash
cp update-manager.conf.example update-manager.conf
cp hosts.conf.example hosts.conf
```
---
### 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
```bash
/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 simple and efficient operations
---
## Requirements
* SSH access to all hosts
* SSH keys recommended (no password prompts)
* Ubuntu/Debian-based systems
---
## Future ideas
* Interactive CLI menu
* Web interface
* Email reporting
* Integration with monitoring systems
---
## License
This project is licensed under the GNU GPL v3 License.
See the LICENSE file for full details.