Core concepts
Domains
Loco helps you streamline access to your local development projects by using convenient .local domains. These domains will be available on any device connected to your Wi-Fi network, making collaboration and testing easier. There are two ways to set up your domains:
Domain Only
What it does: Allows you to access your local projects using a .local domain (e.g., myproject.local) instead of their traditional IP address and port (e.g., 127.0.0.1:3000).
Important: With this setup, you still need to include the original port number in the address bar (e.g., myproject.local:3000).
Use case: Handy when you primarily want the convenience of a domain name rather than advanced routing.
How to set it up
- Open the Loco app and click the "Add Domain" button.
- Enter your desired .local domain name.
- Ensure the proxy checkbox is unchecked.
- Specify the "target IP or hostname" (where your project is running on your local machine) and the "port number" it's using.
Domain with Proxy
What it does: Provides the same .local domain convenience, but adds powerful routing capabilities. Loco handles secure connections (HTTPS) and forwards requests to the correct location on your local network, even if your project is running on a non-standard port.
Use case: Perfect when you want a fully seamless experience where .local domains work exactly like regular website addresses, without having to remember port numbers.
How to set it up
- Open the Loco app and click the "Add Domain" button.
- Enter your desired .local domain name.
- Ensure the proxy checkbox is unchecked.
- Specify the "target IP or hostname" (where your project is running on your local machine) and the "port number" it's using.
- If you want to use HTTPS, make sure to follow the instructions to trust the Loco Root CA certificate.