yakpanel-core/docs/ubuntu-dev-install.md

# YakPanel Ubuntu Dev Install

This setup brings up the YakPanel 2026 scaffold stack on Ubuntu 22.04/24.04.

## Clone the repository

```bash
git clone https://source.yakpanel.com/admin/yakpanel-core.git
cd yakpanel-core
```

## Quick install

```bash
cd /path/to/yakpanel-core
chmod +x scripts/install-ubuntu.sh scripts/bootstrap-dev.sh
./scripts/install-ubuntu.sh
```

## One-click install

```bash
cd /path/to/yakpanel-core
chmod +x one-click-installer.sh
./one-click-installer.sh
```

## Start/stop commands

```bash
make init
make up
make migrate
make ps
make logs
make down
```

## Services
- API health: `http://localhost:8080/health`
- PostgreSQL: `localhost:5432`
- Redis: `localhost:6379`
- NATS monitor: `http://localhost:8222`
- MinIO console: `http://localhost:9001`

## Troubleshooting

### `permission denied while trying to connect to the docker API`

After adding your user to the `docker` group, your **current** shell may not see that group until you log out and back in. Install scripts use `scripts/docker-compose.sh`, which runs Compose via `sg docker` when needed so the first run succeeds without a re-login.

If you still see the error, run:

```bash
newgrp docker
```

or log out and SSH in again, then:

```bash
bash scripts/docker-compose.sh up -d --build
```

## Notes
- This is a development scaffold for the architecture implementation.
- `panel-api` currently serves a minimal runtime entrypoint for health and bootstrap validation.
- Full Laravel production bootstrap (artisan app, providers, migrations runtime wiring) is the next implementation step.
- Database schema is automatically applied by `db-migrate` during bootstrap and can be re-run with `make migrate`.