Getting started

☝️

Install at your own risk

Installation is at your own risk. Please back up your data and only run the script on systems where you have full control.

What gets installed

LuxStage server: Starts automatically at system boot
Web app: Accessible in the browser, full functionality
Caddy Reverse Proxy: Automatic HTTPS, no port needed
PostgreSQL & Redis: Database and cache, pre-configured

1. SSH access to the server

You need SSH access to your server (Linux, Raspberry Pi, etc.)

Connect to your server:

ssh user@192.168.x.x

2. Run the installation script

The script downloads everything and configures the server automatically

Run these two commands:

curl -fsSL https://raw.githubusercontent.com/Plobli/LuxStage/main/install.sh -o /tmp/luxstage-install.sh

sudo bash /tmp/luxstage-install.sh

3. Enter configuration

The script will ask you a few questions. Press Enter for the default values.

System user

The LuxStage service runs under this user. You can also assign your own username.

Systemnutzer [luxstage]: ⏎

Hostname

The app will then be available at http://luxstage.local. You can also set your own local address.

Hostname [luxstage]: ⏎

External domain (optional)

If you want to make LuxStage accessible from the outside, enter your domain (e.g., luxstage.example.com). Otherwise, just skip this step.

Externe Domain []: ⏎

Admin password

At least 8 characters. This will log you in as an admin.

Admin-Password: ••••••••

☝️

Make sure to remember the admin password! You'll need it to log in for the first time.

Tech password: At the end, the script automatically generates a separate password for the tech account. Write it down!

4. Reboot

The script will suggest a restart at the end. Run:

sudo reboot

The server reboots and the LuxStage services start automatically.