2021-07-07 19:09:05 +02:00
<!--
2024-06-23 13:29:19 +02:00
N.B.: This README was automatically generated by < https: / / github . com / YunoHost / apps / tree / master / tools / readme_generator >
2021-07-07 19:09:05 +02:00
It shall NOT be edited by hand.
-->
2020-11-16 19:21:48 +01:00
# Cockpit for YunoHost
2019-02-20 12:08:50 +01:00
2023-08-12 10:35:14 +02:00
[![Integration level ](https://dash.yunohost.org/integration/cockpit.svg )](https://dash.yunohost.org/appci/app/cockpit) ![Working status ](https://ci-apps.yunohost.org/ci/badges/cockpit.status.svg ) ![Maintenance status ](https://ci-apps.yunohost.org/ci/badges/cockpit.maintain.svg )
2021-07-07 19:09:05 +02:00
[![Install Cockpit with YunoHost ](https://install-app.yunohost.org/install-with-yunohost.svg )](https://install-app.yunohost.org/?app=cockpit)
2019-02-20 12:08:50 +01:00
2024-06-23 13:29:19 +02:00
*[Read this README in other languages.](./ALL_README.md)*
2019-02-20 12:08:50 +01:00
2024-06-23 13:29:19 +02:00
> *This package allows you to install Cockpit quickly and simply on a YunoHost server.*
> *If you don't have YunoHost, please consult [the guide](https://yunohost.org/install) to learn how to install it.*
2019-02-20 12:08:50 +01:00
2020-11-16 19:21:48 +01:00
## Overview
2023-08-12 11:07:08 +02:00
Cockpit is an interactive server admin interface. It is easy to use and very lightweight. Cockpit interacts directly with the operating system from a real Linux session in a browser.
2022-03-14 22:02:14 +01:00
2023-09-12 11:37:08 +02:00
**Shipped version:** 239~ynh2
2020-11-16 19:21:48 +01:00
2021-07-07 19:09:05 +02:00
## Screenshots
2019-02-20 12:08:50 +01:00
2022-05-31 01:08:28 +02:00
![Screenshot of Cockpit ](./doc/screenshots/screenshot-storage.png )
2019-02-20 12:08:50 +01:00
2021-07-07 19:09:05 +02:00
## Documentation and resources
2019-02-20 12:08:50 +01:00
2024-06-23 13:29:19 +02:00
- Official app website: < https: // cockpit-project . org />
- Official admin documentation: < https: // cockpit-project . org / documentation . html >
- Upstream app code repository: < https: // github . com / cockpit-project / cockpit >
- YunoHost Store: < https: // apps . yunohost . org / app / cockpit >
- Report a bug: < https: // github . com / YunoHost-Apps / cockpit_ynh / issues >
2019-02-20 12:08:50 +01:00
2020-11-16 19:21:48 +01:00
## Developer info
2019-02-20 12:08:50 +01:00
2024-06-23 13:29:19 +02:00
Please send your pull request to the [`testing` branch ](https://github.com/YunoHost-Apps/cockpit_ynh/tree/testing ).
2019-02-20 12:08:50 +01:00
2024-06-23 13:29:19 +02:00
To try the `testing` branch, please proceed like that:
2022-05-31 01:08:28 +02:00
2024-06-23 13:29:19 +02:00
```bash
2020-11-16 19:21:48 +01:00
sudo yunohost app install https://github.com/YunoHost-Apps/cockpit_ynh/tree/testing --debug
or
sudo yunohost app upgrade cockpit -u https://github.com/YunoHost-Apps/cockpit_ynh/tree/testing --debug
```
2021-07-07 19:09:05 +02:00
2022-05-31 01:08:28 +02:00
**More info regarding app packaging:** < https: / / yunohost . org / packaging_apps >