Installation

Web.Casa can be installed in several ways depending on your environment and preferences. Choose the method that best fits your setup.

One-Click Script

The fastest way to get started. The install script automatically detects your OS, installs dependencies, and configures Web.Casa.

Supported distributions (EL9/EL10):

• AlmaLinux 9+
• Rocky Linux 9+
• CentOS Stream 9+
• RHEL 9+
• Oracle Linux 9+
• Fedora 41+
• openAnolis 9+
• openEuler
• openCloudOS 9+
• Kylin (银河麒麟)

Note

The pre-built binary requires GLIBC >= 2.32. If your system has an older version, use the --from-source flag to compile during installation.

1. Run the install script

   curl -fsSL https://raw.githubusercontent.com/web-casa/webcasa/main/install.sh | sudo bash

2. Access the panel

   Once installation completes, open your browser and navigate to:

   http://YOUR_SERVER_IP:39921

3. Complete the setup wizard

   Follow the on-screen prompts to create your admin account and configure initial settings.

Docker

Run Web.Casa in a container using the included Docker Compose configuration.

1. Clone the repository and start the container

   git clone https://github.com/web-casa/webcasa.git
   cd webcasa
   docker compose up -d

2. Access the panel

   Open your browser and navigate to:

   http://YOUR_SERVER_IP:39921

Build from Source

Build Web.Casa from source if you need full control over the build process or your system does not meet the GLIBC requirement for pre-built binaries.

Prerequisites:

• Go 1.26+
• Node.js 24+
• GCC

1. Clone the repository

   git clone https://github.com/web-casa/webcasa.git
   cd webcasa

2. Build the frontend

   cd web
   npm install
   npm run build
   cd ..

3. Build the backend

   go build -o webcasa .

4. Start the server

   ./webcasa

   The panel will be available at http://YOUR_SERVER_IP:39921.

Tip

You can also use the one-click script with the --from-source flag to automate the source build process:

curl -fsSL https://raw.githubusercontent.com/web-casa/webcasa/main/install.sh | sudo bash -s -- --from-source

Install Script Flags

The one-click install script accepts the following flags:

Flag	Description
--port PORT	Set a custom panel port (default: 39921)
--no-caddy	Skip Caddy web server installation
--no-docker	Skip Docker group setup
--from-source	Build from source code instead of using the pre-built binary
-y, --yes	Run in non-interactive mode (accept all defaults)

Example: Install on a custom port without Caddy:

curl -fsSL https://raw.githubusercontent.com/web-casa/webcasa/main/install.sh | sudo bash -s -- --port 8080 --no-caddy

Upgrade

To upgrade an existing installation to the latest version:

curl -fsSL https://raw.githubusercontent.com/web-casa/webcasa/main/install.sh | sudo bash -s -- --upgrade

To upgrade by building from source:

curl -fsSL https://raw.githubusercontent.com/web-casa/webcasa/main/install.sh | sudo bash -s -- --upgrade-from-source

Uninstall

Remove Web.Casa but keep your data:

curl -fsSL https://raw.githubusercontent.com/web-casa/webcasa/main/install.sh | sudo bash -s -- --uninstall

Data and configuration files in /var/lib/webcasa/ and /etc/webcasa/webcasa.env will be preserved.

Completely remove Web.Casa including all data:

curl -fsSL https://raw.githubusercontent.com/web-casa/webcasa/main/install.sh | sudo bash -s -- --purge

Caution

The --purge flag permanently deletes all Web.Casa data, including site configurations and databases. This action cannot be undone.