Guia de instalação

Aloje o HospitalityOps na sua infraestrutura

Implemente a API e o centro de comando com Docker, ligue o Supabase e proteja os serviços com HTTPS.

Antes de começar

Linux VPS with Docker Engine and Docker Compose
Two DNS records for the API and command center
A Supabase project in your preferred region
Access to the HospitalityOps deployment package

Choose your installation path

Ubuntu Server or Docker Compose?

They are not two different versions of HospitalityOps. Ubuntu Server is the full production-server walkthrough; Docker Compose is the tool used to run HospitalityOps once Docker is available.

Production deployment

Ubuntu Server installation

A complete installation for a fresh Ubuntu VPS, including the Docker runtime and public HTTPS access.

01

Prepare Ubuntu Server

Use Ubuntu Server 22.04 or 24.04 LTS on a VPS or dedicated server. A practical starting point is 2 vCPU, 4 GB RAM and 40 GB SSD.

sudo apt update
sudo apt upgrade -y
sudo apt install -y ca-certificates curl git ufw

02

Install Docker Engine and Compose

Install Docker from Docker's official repository. The Compose plugin lets the server run the complete HospitalityOps stack as a coordinated set of containers.

curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER
newgrp docker
docker compose version

03

Create and configure Supabase

Create a Supabase project in your preferred region, disable public sign-ups and apply the supplied migrations. Keep the service-role key on the server only.

supabase db push

04

Install the deployment package

Place the HospitalityOps deployment package in /opt, copy the environment template and enter the Supabase credentials, encryption key and integration settings.

sudo mkdir -p /opt/hospitality-operations
cd /opt/hospitality-operations
cp .env.example .env
nano .env

05

Set the public API address

Before building, set NEXT_PUBLIC_API_URL to the final HTTPS API domain. This value is embedded in the command-center build.

NEXT_PUBLIC_API_URL=https://ops-api.yourdomain.com

06

Build and start HospitalityOps

Build the API and command-center images, start them in the background and confirm that both containers remain healthy.

docker compose build
docker compose up -d
docker compose ps

07

Configure DNS and HTTPS

Point both DNS records to the server. Use Caddy, Traefik or nginx as the public reverse proxy. The application containers should remain bound to localhost.

ops-api.yourdomain.com   → 127.0.0.1:4100
ops-admin.yourdomain.com → 127.0.0.1:3100

08

Secure and verify

Allow SSH, HTTP and HTTPS through the firewall, then verify the deep API health endpoint and sign in to the command center.

sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
curl -fsS https://ops-api.yourdomain.com/health?deep=1

Precisa de ajuda?

Pro cobre a instalação padrão. Não garantimos suporte após alterações ou personalizações do cliente.

Consultar Pro

Prefere Cloud?

Cloud inclui alojamento, base de dados, backups, atualizações, monitorização, segurança e suporte.

Teste grátis por 7 dias