Laravel LXC Bootstrap

Spin up a fully configured Laravel development container in one step: SSH, Apache/PHP/MariaDB or SQLite, Composer, a Laravel project, code-server, and Claude Code — all from a single command pasted into a fresh Proxmox LXC.

Quick start

In an empty, freshly created LXC, logged in as root:

curl -fsSL https://git.innovator.bh/ghassan/laravel-project/raw/branch/main/bootstrap.sh -o bootstrap.sh && bash bootstrap.sh

You'll be prompted for:

• Laravel project name
• Git repository to clone (leave blank to scaffold a brand-new Laravel project instead)
• Database: mysql or sqlite
• MariaDB username/password/database (only if you chose mysql)

When it finishes you'll have a running Laravel site, code-server, and Claude Code installed.

Fully unattended install

Skip every prompt by exporting variables before running the script (useful for scripted LXC provisioning):

APP_NAME=myapp \
GIT_REPO="" \
DB_TYPE=sqlite \
INSTALL_CODE_SERVER=yes \
INSTALL_CLAUDE_CODE=yes \
bash bootstrap.sh

Variable	Description	Default
APP_NAME	Project directory name under /var/www	laravel-app
GIT_REPO	Git URL to clone; blank creates a new Laravel project	(blank)
DB_TYPE	mysql or sqlite	sqlite
DB_USER	MariaDB username (mysql only)	laravel_user
DB_PASS	MariaDB password (mysql only)	random
DB_NAME	MariaDB database name (mysql only)	laravel_db
INSTALL_CODE_SERVER	Install code-server	yes
INSTALL_CLAUDE_CODE	Install Node.js + Claude Code	yes
FIX_SSHD	Auto-relax sshd config (TurnKey TCP forwarding / Ubuntu root login)	yes

What the script does

1. Base system — apt update/upgrade, installs sudo curl git wget unzip.
2. SSH — installs and enables openssh-server; on TurnKey Core containers enables AllowTcpForwarding, on other distros enables PermitRootLogin yes (needed for VS Code Remote-SSH / port tunneling).
3. Laravel stack — Apache, PHP + required extensions, MariaDB or SQLite, Composer, clones or scaffolds the Laravel project, sets permissions, configures an Apache vhost, generates .env, runs key:generate and migrate.
4. code-server — browser-based VS Code, so you can edit the app over SSH without a local editor.
5. Claude Code — installs Node.js LTS, then npm install -g @anthropic-ai/claude-code.
6. Prints a summary with the app path, DB type, container IP, and next steps.

After install

• Edit the app: code-server /var/www/<app-name> then open the tunneled port (8080) in your browser.
• Use Claude Code: cd /var/www/<app-name> && claude

Manual SSH config notes (if you skip FIX_SSHD)

TurnKey Core:

nano /etc/ssh/sshd_config.d/turnkey.conf
# set: AllowTcpForwarding yes

Ubuntu:

nano /etc/ssh/sshd_config
# set: PermitRootLogin yes

Standard Claude Code project prompt

For a consistent architecture baseline (mobile-first React frontend, Laravel API backend, RBAC, MQTT real-time updates, SQLite↔PostgreSQL portability, security-first defaults), start every new Claude Code session in the project with claude-project-prompt.md as the system/instruction prompt.

Legacy scripts

The original interactive, single-purpose scripts are still available if you don't want the full bootstrap:

• install-laravel.sh — Laravel + MySQL only, interactive prompts.
• install-laravel-ad.sh — Laravel + MySQL/SQLite choice, interactive prompts.

bootstrap.sh supersedes both and additionally installs SSH hardening, code-server, and Claude Code in one pass.