File · CVT8858

FileLocal panel · 127.0.0.1:8858

File: /home/webhost/domains/cvt8858.aurorum.co/public/README.md

# CVT8858

CVT8858 is a lightweight Python-based VPS control panel with a headless plugin core and a local web UI.

This package is the complete apply-capable build. It manages existing system services instead of bundling its own stack.

## Run

```bash
python3 panelctl.py install
python3 panelctl.py doctor
python3 panelctl.py plugin start panel
```

Open:

```text
http://127.0.0.1:8858
```

## Main model

- Caddy is the default front door.
- Apache is kept for legacy `.htaccess` sites.
- MariaDB/MySQL is called through the existing local client.
- Node/Python apps are applied as systemd services.
- Cron jobs are installed into a CVT8858-managed crontab block.
- Config writes are scoped to CVT8858-managed paths where possible.

## First Caddy adoption

From the UI, open **Caddy** and click **Adopt existing Caddy**. This adds one import line to `/etc/caddy/Caddyfile`:

```caddy
import /etc/caddy/CVT8858/*.caddy
```

Then CVT8858-created domains are stored as independent fragments under `/etc/caddy/CVT8858/`.

## Notes

Some apply actions write to `/etc` and reload services. Run the panel with the privileges needed for those system operations, or use the CLI/action dry-run mode first.

## Visual setup wizard

CVT8858 now includes a Python + HTML setup wizard:

```bash
python3 setup.py
```

Default mode binds to `127.0.0.1:8859`, prints a random token URL, and is meant
for SSH tunneling from your own computer:

```bash
ssh -L 8859:127.0.0.1:8859 user@server
```

Then open the printed URL locally. You can also run:

```bash
python3 panelctl.py setup
python3 setup.py --host 0.0.0.0 --port 8859
```

The setup wizard can detect existing Caddy and MariaDB/MySQL, initialize CVT8858,
create an admin user, adopt Caddy safely through an import line, publish the panel
through Caddy, and optionally install a systemd service.

See `docs/setup.md` for details.

## Visual installer

Run on the VPS:

```bash
python3 setup.py
```

Open it from your own computer with SSH tunneling:

```bash
ssh -L 8859:127.0.0.1:8859 user@server
```

The installer is now a step-by-step wizard: environment check, package installation, core/admin setup, Caddy adoption, MariaDB mode, review plan, and run.

Back

Encoding: utf-8, size: 2205, truncated: False