Files
yakpanel-core/docs/ubuntu-dev-install.md
2026-04-07 20:53:04 +05:30

1.7 KiB

YakPanel Ubuntu Dev Install

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

Clone the repository

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

Quick install

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

One-click install

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

Start/stop commands

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:

newgrp docker

or log out and SSH in again, then:

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.