How to Change the Default ORDS Landing Page in Oracle APEX?

Ever hit your domain and land on the default ORDS page instead of your APEX app? Here's a simple hack to fix that without touching your load balancer or proxy configs.

Before

misdemo.maathradev.com redirects to misdemo.maathradev.com/ords/_/landing

After

misdemo.maathradev.com redirects to misdemo.maathradev.com/ords/r/mtc/demo/login (APEX app landing page)

Assumptions

• ORDS is installed as a service on Oracle Linux (You can run in standalone mode also)

• ORDS is already configured and running

• Oracle APEX application is available and accessible

• You are using customer managed ORDS

The One-Liner Solution

ords config set misc.defaultPage r/mtc/demo/login

That's it. Restart ORDS and you're done.

Breaking Down the Path

The format is: r/{workspace}/{app_alias}/{page_alias}

• mtc = your workspace name

• demo = your application alias

• login = your landing page alias

Example

Let's say you want users to land directly on your sales dashboard:

sudo systemctl stop ords
sudo -iu oracle
ords config set misc.defaultPage r/sales/crm/dashboard
exit
sudo systemctl start ords

Now when someone visits yourdomain.com, they go straight to your dashboard instead of the default ORDS page.

Why This Works

ORDS has a built-in configuration parameter misc.defaultPage that most people don't know about. Instead of setting up redirect rules elsewhere, you're just telling ORDS where to send users by default.

Quick Tips

• Make sure your page alias exists and is published

• Test in dev first

• You need to restart ORDS for changes to take effect

That's the hack. Simple, clean, and no infrastructure changes needed.

References

• https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/25.2/ordig/about-REST-configuration-files.html#GUID-006F916B-8594-4A78-B500-BB85F35C12A0