Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sergi0g/cup

🥤Docker container updates made easy
https://github.com/sergi0g/cup

cli container docker docker-container docker-image dockerhub react rust self-hosted server tailwindcss terminal update updates

Last synced: 3 days ago
JSON representation

🥤Docker container updates made easy

Host: GitHub
URL: https://github.com/sergi0g/cup
Owner: sergi0g
License: agpl-3.0
Created: 2024-06-15T08:44:37.000Z (7 months ago)
Default Branch: main
Last Pushed: 2024-10-27T18:29:55.000Z (3 months ago)
Last Synced: 2024-10-29T20:33:42.202Z (3 months ago)
Topics: cli, container, docker, docker-container, docker-image, dockerhub, react, rust, self-hosted, server, tailwindcss, terminal, update, updates
Language: Rust
Homepage: https://sergi0g.github.io/cup/docs
Size: 1.34 MB
Stars: 130
Watchers: 2
Forks: 1
Open Issues: 7
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

README

# Cup 🥤

Cup is the easiest way to check for container image updates.

![Cup web in dark mode](screenshots/web_dark.png)

_If you like this project and/or use Cup, please consider starring the project ⭐. It motivates me to continue working on it and improving it. Plus, you get updates for new releases!_

## Screenshots 📷

![Cup web in light mode](screenshots/web_light.png)
![Cup's CLI](screenshots/cup.gif)

## Features ✨

- Extremely fast. Cup takes full advantage of your CPU and is hightly optimized, resulting in lightning fast speed. On my Raspberry Pi 5, it took 3.7 seconds for 58 images!
- Supports most registries, including Docker Hub, ghcr.io, Quay, lscr.io and even Gitea (or derivatives)
- Doesn't exhaust any rate limits. This is the original reason I created Cup. It was inspired by [What's up docker?](https://github.com/getwud/wud) which would always use it up.
- Beautiful CLI and web interface for checking on your containers any time.
- The binary is tiny! At the time of writing it's just 5.2 MB. No more pulling 100+ MB docker images for a such a simple program.
- JSON output for both the CLI and web interface so you can connect Cup to integrations. It's easy to parse and makes webhooks and pretty dashboards simple to set up!

## Documentation 📘

Take a look at https://sergi0g.github.io/cup/docs!

## Limitations

Cup is a work in progress. It might not have as many features as other alternatives. If one of these features is really important for you, please consider using another tool.

- Cup (currently) does not support semver.
- Cup cannot directly trigger your integrations. If you want that to happen automatically, please use What's up Docker instead. Cup was created to be simple. The data is there, and it's up to you to retrieve it (e.g. by running `cup check -r` with a cronjob or periodically requesting the `/json` url from the server).

## Roadmap
Take a sneak peek at what's coming up in future releases on the [roadmap](https://github.com/users/sergi0g/projects/2)!

## Contributing

All contributions are welcome!

Here are some ideas to get you started:

- Fix a bug from the [issues](https://github.com/sergi0g/cup/issues)
- Help improve the documentation
- Help optimize Cup and make it even better!
- Add more features to the web UI

For more information, check the [docs](https://sergi0g.github.io/cup/docs/contributing)!

## Support

If you have any questions about Cup, feel free to ask in the [discussions](https://github.com/sergi0g/cup/discussions)!

If you find a bug, or want to propose a feature, search for it in the [issues](https://github.com/sergi0g/cup/issues). If there isn't already an open issue, please open one.

## Acknowledgements

Thanks to [What's up Docker?](https://github.com/getwud/wud) for inspiring this project.