This commit is contained in:
@@ -1,76 +0,0 @@
|
|||||||
# cockpit
|
|
||||||
|
|
||||||
**Install Cockpit web-based server management interface**
|
|
||||||
|
|
||||||
## Purpose
|
|
||||||
|
|
||||||
This cube installs Cockpit, a powerful web-based interface for managing Linux servers, making system administration accessible through your browser.
|
|
||||||
|
|
||||||
## What is Cockpit?
|
|
||||||
|
|
||||||
Cockpit is a modern, interactive server admin interface that runs in your web browser. It provides:
|
|
||||||
|
|
||||||
- **Real-time monitoring**: CPU, memory, disk, and network usage graphs
|
|
||||||
- **Container management**: View and manage Docker containers
|
|
||||||
- **Service management**: Start, stop, and manage systemd services
|
|
||||||
- **Storage administration**: Manage disks, RAID, and filesystems
|
|
||||||
- **Network configuration**: Configure network interfaces and firewall
|
|
||||||
- **Terminal access**: Built-in terminal for command-line access
|
|
||||||
- **User management**: Create and manage user accounts
|
|
||||||
- **Software updates**: View and apply system updates
|
|
||||||
|
|
||||||
Think of it as a control panel for your Linux server - all accessible from any web browser.
|
|
||||||
|
|
||||||
## What This Cube Does
|
|
||||||
|
|
||||||
1. Installs the `cockpit` package
|
|
||||||
2. Installs `sscg` (Simple Signed Certificate Generator) for HTTPS support
|
|
||||||
3. Starts the Cockpit service
|
|
||||||
4. Makes Cockpit accessible on port 9090
|
|
||||||
|
|
||||||
## Configuration
|
|
||||||
|
|
||||||
This cube currently has no configurable parameters.
|
|
||||||
|
|
||||||
## Dependencies
|
|
||||||
|
|
||||||
None - this cube can run standalone.
|
|
||||||
|
|
||||||
## Post-Installation
|
|
||||||
|
|
||||||
Access Cockpit by navigating to:
|
|
||||||
```
|
|
||||||
https://your-server-ip:9090
|
|
||||||
```
|
|
||||||
|
|
||||||
Login with any valid system user account (e.g., root or a user created with the `user-add` cube).
|
|
||||||
|
|
||||||
### Security Notes
|
|
||||||
|
|
||||||
- Cockpit uses HTTPS by default (self-signed certificate)
|
|
||||||
- Your browser will show a security warning on first access (expected with self-signed certs)
|
|
||||||
- Consider using UFW to restrict access: `sudo ufw allow from YOUR_IP to any port 9090`
|
|
||||||
- Disable Cockpit when not in use: `sudo systemctl stop cockpit.socket`
|
|
||||||
|
|
||||||
## Common Use Cases
|
|
||||||
|
|
||||||
- Monitor server performance in real-time
|
|
||||||
- Manage Docker containers without command-line
|
|
||||||
- View system logs and troubleshoot issues
|
|
||||||
- Configure network settings
|
|
||||||
- Apply system updates
|
|
||||||
- Manage storage and filesystems
|
|
||||||
|
|
||||||
## Managing Cockpit
|
|
||||||
|
|
||||||
Start/stop Cockpit:
|
|
||||||
```bash
|
|
||||||
sudo systemctl start cockpit.socket
|
|
||||||
sudo systemctl stop cockpit.socket
|
|
||||||
sudo systemctl status cockpit.socket
|
|
||||||
```
|
|
||||||
|
|
||||||
Disable Cockpit from starting on boot:
|
|
||||||
```bash
|
|
||||||
sudo systemctl disable cockpit.socket
|
|
||||||
```
|
|
||||||
@@ -1,13 +0,0 @@
|
|||||||
from pyinfra import host
|
|
||||||
from pyinfra.operations import server, apt
|
|
||||||
|
|
||||||
apt.packages(
|
|
||||||
packages=[ "sscg cockpit"],
|
|
||||||
present=True,
|
|
||||||
_sudo=True
|
|
||||||
)
|
|
||||||
|
|
||||||
server.service(
|
|
||||||
'cockpit',
|
|
||||||
running=True,
|
|
||||||
)
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
import { Manifest } from '@bitsquare/nopy-cubes';
|
|
||||||
|
|
||||||
export default Manifest({
|
|
||||||
id: 'admin:cockpit',
|
|
||||||
name: 'Install cockpit and utils',
|
|
||||||
dependencies: () => [],
|
|
||||||
});
|
|
||||||
Reference in New Issue
Block a user