For the team

Running the server

For whoever looks after the server: what runs where, the important settings, backups, health checks and how to update.

What runs #

PartWhat it is
API (backend)The Spring Boot server. All the apps and portals talk to it. Health check: /actuator/health.
DatabasePostgreSQL with PostGIS, in a Docker container.
Business portal and admin portalStatic websites.
Public websiteStatic pages (home, for businesses, help). The blog, the sitemap and blog pictures come from the backend.
Customer appThe Android app. It talks to the API.

Important settings #

They live in the server's .env file (see deploy/.env.production.example).

SettingMeaning
ORYLO_SITE_URLThe public website address, for blog links and the sitemap.
ORYLO_PLAY_STORE_URLThe Google Play link, once the app is published.
ORYLO_BRAND_NAMEThe name used in emails.
ORYLO_EMAIL_MODE and the mail settingsHow emails are sent. log only prints them (for testing).
ORYLO_BOOTSTRAP_ADMIN_EMAIL and ..._PASSWORDCreates the first super admin on a new server if none exists.
ORYLO_API_URLThe public address of the API. Used in payment links and the payment test page. The compose files set it from DOMAIN.

Backups #

The database and the uploaded pictures must be backed up. Use deploy/backup.sh on a schedule and copy the result off the server. Test a restore with deploy/restore.sh at least once.

Updating #

  1. Take a backup.
  2. Get the new code and rebuild the containers, as in the deployment guide.
  3. Check /actuator/health and open the portals.
  4. Database changes run automatically at start-up.

Background jobs #

The server runs small jobs by itself: ending orders nobody answered in time, expiring cab and guide requests after 12 hours, and releasing seafood stock. If they stop, orders may stay open longer than they should. Check the server log if so.

Where to look when something is wrong #

ProblemCheck
Nobody can log inThe email setting; the .env mail credentials; the log for send errors.
Pictures missingThe media folder is mounted and has space.
Website blog empty or errorsThe proxy rules for /blog, /sitemap.xml and /api/v1/media on the website's server block.
Slow or downThe container status and the disk space.

Last updated 2026-11-15. Something unclear or out of date? Write to hrdoisoftwares@gmail.com or call 6383281461.