Skip to content

Point a micro at another database

Goal: have a micro start against another database (the cloud one, a different local one, one from the catalog) without editing its repository.

  1. In the Databases section, create the connection (engine, host, port, user, password as ${creds.x}) and test it (TCP reachability).
  2. In the micro’s editor, inside the startup configuration, open the database selector and choose that connection. Its host:port replaces the one in the URL the micro already declares.

If the connection brings a user and password but the micro doesn’t declare the config keys to inject them into, MicroLab warns (only the URL would change). Use “Update manifest from the repository” to autodetect them.

In the same selector you can choose directly:

  • Local — the local URL the micro declares (default).
  • Cloud — the devUrl the micro declares (may require credentials/VPN).
  • Custom — a JDBC URL you write.

This customization is local and non-versioned (it lives in your settings.local.yml), so each machine points wherever it wants without affecting the rest of the team.