Quick Install (recommended)

🛠️ Initial Setup

Before starting the installation, make sure Docker is installed on your system.

📦 Installing Docker

You need Docker to run the Smart Home stack. If you haven't installed it yet, follow the official guide:

👉 Install Docker

---

Wget or Curl required

To Download and run the setup script, your system must be have either curl or wget installed.

📥Installing curl

On Ubuntu/Debian:

sudo apt update
sudo apt install curl

On Fedora:

First, install Snap if it’s not already installed:

sudo dnf install snapd
sudo ln -s /var/lib/snapd/snap /snap

Then install curl using Snap:

sudo snap install curl

On Arch:

sudo pacman -S curl

---

📥Installing

Using Curl:

bash <(curl -s https://raw.githubusercontent.com/L0rdL0ther/WSHome/refs/heads/main/Setup.sh)

Using Wget:

bash <(wget -qO- https://raw.githubusercontent.com/L0rdL0ther/WSHome/refs/heads/main/Setup.sh)

🔧 What it does:

• Prompts you for:

  • Site access method (IP/domain)

  • Custom frontend and backend ports (defaults: 80 and 8237)

• Automatically generates:

  • Secure database credentials

  • JWT secret

• Creates:

  • Docker network smart-home-net

  • Containers for PostgreSQL, Backend, and Frontend

• Sets proper environment variables for container communication

---

✅ You're All Set!

Once the script finishes, all services (PostgreSQL, Backend, Frontend) will be automatically deployed via Docker containers.

You can now access your Smart Home interface at:

http://<your-domain-or-ip>:<chosen-frontend-port>

🔒 Admin credentials and other configuration details will be securely generated during setup.