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 #
| Part | What it is |
|---|---|
| API (backend) | The Spring Boot server. All the apps and portals talk to it. Health check: /actuator/health. |
| Database | PostgreSQL with PostGIS, in a Docker container. |
| Business portal and admin portal | Static websites. |
| Public website | Static pages (home, for businesses, help). The blog, the sitemap and blog pictures come from the backend. |
| Customer app | The Android app. It talks to the API. |
Important settings #
They live in the server's .env file (see deploy/.env.production.example).
| Setting | Meaning |
|---|---|
ORYLO_SITE_URL | The public website address, for blog links and the sitemap. |
ORYLO_PLAY_STORE_URL | The Google Play link, once the app is published. |
ORYLO_BRAND_NAME | The name used in emails. |
ORYLO_EMAIL_MODE and the mail settings | How emails are sent. log only prints them (for testing). |
ORYLO_BOOTSTRAP_ADMIN_EMAIL and ..._PASSWORD | Creates the first super admin on a new server if none exists. |
ORYLO_API_URL | The 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 #
- Take a backup.
- Get the new code and rebuild the containers, as in the deployment guide.
- Check
/actuator/healthand open the portals. - 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 #
| Problem | Check |
|---|---|
| Nobody can log in | The email setting; the .env mail credentials; the log for send errors. |
| Pictures missing | The media folder is mounted and has space. |
| Website blog empty or errors | The proxy rules for /blog, /sitemap.xml and /api/v1/media on the website's server block. |
| Slow or down | The 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.