Snabbstart

Den här guiden leder dig genom att driftsätta en självhostad rtCloud-instans på en Linux-server från grunden. I slutet har du en körande rtCloud tillgänglig i din webbläsare.

Förutsättningar link

Se till att din server uppfyller följande krav innan du börjar:

Hårdvara link

Programvara link

Installera Docker på Ubuntu:

  curl -fsSL https://get.docker.com | sh
  

Verifiera installationen:

  docker --version
docker compose version
  

Steg 1 — Hämta filerna link

Klona driftsättningsförrådet till din server:

  git clone ssh://git@rtgit.rta.vn:2224/rtlab/rtwebteam/rta-smart-survey-docker.git rtcloud
cd rtcloud
  

Steg 2 — Konfigurera miljön link

Kopiera exempelkonfigurationsfilen:

  cp .env.production.sample .env
  

Öppna .env i en textredigerare och fyll i de obligatoriska värdena:

  # Unik identifierare för denna driftsättning (inga mellanslag, inga specialtecken)
PROJECT_ID=mittproject

# Domän eller IP-adress där användare kommer åt appen
# Exempel: rtcloud.example.com  eller  192.168.1.100
PROJECT_URL=rtcloud.example.com

# Protokoll: använd "https" om du har en domän med SSL, annars "http"
HTTP_PROTOCOL=https

# Starka, unika lösenord — ändra alla tre innan start
MYSQL_PASSWORD=change_me_strong_password
MYSQL_ROOT_PASSWORD=change_me_root_password
ADMIN_PASSWORD=change_me_admin_password
  

Viktigt: Endast .env läses av Docker Compose automatiskt. Skapa inte en fil med namnet .env.production, eftersom det kan orsaka förvirring. ADMIN_PASSWORD tillämpas endast vid första starten av en ny databas.

Steg 3 — Starta containrarna link

Starta alla tjänster i bakgrunden:

  docker compose -f docker-compose.production.yml up -d
  

Den första starten tar 3–5 minuter medan Docker:

1. Hämtar rtCloud-applikationsavbilden (~1 GB nedladdning)
2. Initialiserar MySQL-databasen
3. Läser in basschemat
4. Kör alla väntande databasmigrationer

Övervaka startförloppet i realtid:

  docker compose -f docker-compose.production.yml logs -f rtcloud
  

Vänta tills du ser utdata som indikerar att applikationen är redo. Du kan också se containrarnas hälsostatus:

  watch docker compose -f docker-compose.production.yml ps
  

Steg 4 — Få åtkomst till applikationen link

När båda containrarna visar Up (healthy), öppna din webbläsare:

  http://<PROJECT_URL>:8080
  

Logga in med administratörskontot:

Ändra adminlösenordet omedelbart efter din första inloggning från kontoinställningssidan.

Steg 5 — Verifiera alla tjänster link

Kontrollera att alla containrar körs och är friska:

  docker compose -f docker-compose.production.yml ps
  

Förväntat resultat:

  NAME                    IMAGE                                   STATUS
rtcloud-app             rtawebteam/rta-smartsurvey:...          Up (healthy)
rtcloud-mysql           mysql:8.0                               Up (healthy)
  

Om en container visar Up (starting) eller Up (unhealthy), vänta 30–60 sekunder till och kontrollera igen. MySQL kan ta upp till en minut att fullt initialiseras vid första starten.

Portreferens link

MySQL (port 3306) och eventuella valfria tjänster (Keycloak) är endast interna och exponeras inte till värden som standard.

Nästa steg link

Din rtCloud-instans körs nu. Överväg dessa uppföljningsuppgifter:

• Aktivera HTTPS — Peka en domän mot din server och konfigurera SSL med Let’s Encrypt. Se Molndriftsättning för automatisk HTTPS-konfiguration.
• Granska alla inställningar — Bläddra i Konfigurationsreferensen för att justera din driftsättning för produktion.
• Konfigurera SSO — Anslut en identitetsleverantör för centraliserad användarautentisering. Se SSO-autentisering.
• Planera dina säkerhetskopior — Granska sidan Underhåll för säkerhetskopierings- och uppgraderingsprocedurer.