69 lines
1.7 KiB
Markdown
69 lines
1.7 KiB
Markdown
# 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`.
|