"AUTH_SECRET is missing or too short"
The dashboard signs its session cookie with AUTH_SECRET. Set it in .env to 32 or more random characters and restart. Changing it later signs everyone out of the dashboard, nothing else.
"Settings row missing: run npm run db:seed"
The database exists but is empty. Run npm run db:seed (or npm run setup on a new copy).
"Set OWNER_PASSWORD (10+ characters)" when seeding
The seed creates the first owner from OWNER_EMAIL and OWNER_PASSWORD. Put a password of at least 10 characters in .env.
The seed fails with "Unknown file extension .ts" or a syntax error
The seed and the unit tests import src/lib/booking-rules.ts directly, which needs Node.js 22.18 or newer. Check with node -v and upgrade.
A stay shows as free on the calendar but booking says the nights are taken
Someone else booked one of those nights a moment earlier: the calendar was loaded before. The answer is correct (the database refuses the second booking). Reload the page to see the current calendar.
Card bookings hold their nights for 30 minutes while the guest is on Thawani's page. If the payment is never finished, the nights are released automatically on the next search or booking.
Dates are off by one day
"Today" comes from COMPANY_TIMEZONE (default Asia/Muscat), not from the server's clock. Set it to the time zone of your stays.
"Card (Thawani)" does not appear in the booking form
All of these must be true:
THAWANI_SECRET_KEYandTHAWANI_PUBLISHABLE_KEYare set in.env(restart after editing).- Dashboard > Company settings > Payments > Card payments is on.
- The currency is
OMR: Thawani charges in Omani rials only.
See Payments.
The guest cannot see the door code
The door code appears in Find your booking from the day before arrival, and only for confirmed or checked-in bookings. A request to book stays PENDING until the host confirms it.
The sign-in page keeps coming back
- The browser blocks cookies for the site: allow them.
- In production
SITE_URLstarts withhttps://but the site is opened overhttp://: the secure cookie is not sent. Use HTTPS or fixSITE_URL. - The account was deactivated in Dashboard > Admins.
A host says the dashboard is empty
Hosts only see stays assigned to them. Open the stay in Dashboard > Stays and choose the host in Host.
Uploading a photo fails
- Only JPEG, PNG or WebP up to 4 MB are accepted; the real file type is checked, not its name.
- Behind Nginx, set
client_max_body_size 5m;. - On hosts with a read-only disk, uploads cannot be saved in
public/uploads: see Manual setup and deployment.
"Too many requests"
Public actions are limited per visitor: 6 bookings, 10 booking lookups, 5 inquiries and 120 price checks per minute, and 10 sign-in attempts per minute (8 per email per 15 minutes). The counters live in the server's memory and reset when it restarts. Behind a proxy, make sure it sets X-Forwarded-For, or every visitor shares one counter.
I changed prisma/schema.prisma and the app fails
Apply the change and rebuild the client:
npx prisma db push
npx prisma generate