Olares

English

简体中文

English

简体中文

Appearance

Access Olares services locally ​

Typically, you access Olares services through a browser using a URL like https://desktop.<username>.olares.com. This way, you can reach your services from any device at any time.

However, accessing your devices directly over your Local Area Network (LAN) provides several advantages:

  • Maximum performance: Transfer files at full speed without the latency and potential bottlenecks of the internet.
  • Enhanced privacy: Keep your traffic contained within your home network for added security.
  • Offline independence: Access your data and apps even when your internet service is unavailable.

This guide covers several methods to establish a local connection:

  • Enable LarePass VPN (Recommended)
    This method is the easiest solution, as it automatically establishes the fastest connection without manual configuration.
  • Use .local domain
    This method requires no installation, though you must use specific URL formats based on your operating system.
  • Configure local DNS (Advanced)
    This method allows standard URLs to work locally by updating DNS settings on your router or individual computer.
  • Modify host files (Fallback)
    This method manually maps standard URLs to your local IP on a single computer, ensuring access even without an internet connection.

Method 1: Enable LarePass VPN ​

The most robust way to connect, whether you are sitting next to the device or traveling, is using the LarePass VPN. It intelligently detects when you are on the same network and switches to a direct Intranet mode for maximum speed.

Always enable VPN for remote access

Keep LarePass VPN enabled. It automatically prioritizes the fastest available route to ensure you always get the best speed possible without manual switching.

iOS and macOS setup

On iOS or macOS, you may be prompted to add a VPN Configuration to your system settings the first time you enable the feature. Allow this to complete the setup.

Enable the LarePass VPN directly on the device you are currently using to access Olares.

Once enabled, check the status indicator in LarePass to verify the connection type:

StatusDescription
IntranetDirect connection via your local LAN IP. Fastest speeds.
P2PDirect encrypted tunnel between devices. High speed.
DERPRouted via a secure relay server. Used as a fallback.

Method 2: Use .local domain ​

If you prefer not to use a VPN, you can access services using the .local domain. There are two domain formats available depending on your compatibility needs.

Single-level domain (All operating systems) ​

Supported for community apps only

Olares system apps such as Desktop and Files do not support this URL format and will not load correctly.

This format uses a single-level domain by connecting the entrance ID and the username with hyphens (-).

  • Default URL:
    plain
    https://<entrance_id>.<username>.olares.com
  • Local-access URL:
    plain
    http://<entrance_id>-<username>-olares.local

Multi-level domain (macOS and iOS only) ​

Apple devices support local service discovery via Bonjour (zero‑configuration networking), which can resolve multi‑label domains under .local on macOS and iOS. This allows a local URL format that mirrors the remote address.

  • Default URL:
    plain
    https://<entrance_id>.<username>.olares.com
  • Local-access URL:
    plain
    http://<entrance_id>.<username>.olares.local

Multi-level local domain

Method 3: Configure local DNS ​

For a seamless experience where standard URLs resolve to your local IP address automatically, you can configure your network DNS. This configuration ensures consistent access across all devices on the network without requiring individual client setup.

Find the internal IP for Olares device ​

To configure DNS, first you need to find the internal IP for your Olares device.

Configure DNS ​

With the internal IP address identified, you must now configure your DNS settings to route traffic correctly. You can apply this configuration to a single computer for individual access, or update your router to enable seamless local resolution for all devices on your network.

Once configured, you can access Olares using both your standard public address and your local address.

TIP

You can install AdGuard Home from the Olares Market to monitor traffic and manage DNS mappings graphically.

Method 4: Modify host files ​

If you cannot change router settings and need immediate offline access on a specific computer, you can manually map the domains in your hosts file.

  1. Locate your hosts file:
    • Windows: C:\Windows\System32\drivers\etc\hosts
    • macOS/Linux: /etc/hosts
  2. Open the file with a text editor, which requires Administrator privileges.
  3. Add the mapping lines:
    plain
    # Replace with the actual internal IP and the username
# Olares apps
192.168.31.208  desktop.<username>.olares.com
192.168.31.208  auth.<username>.olares.com
192.168.31.208  files.<username>.olares.com
192.168.31.208  market.<username>.olares.com
192.168.31.208  settings.<username>.olares.com
192.168.31.208  dashboard.<username>.olares.com
192.168.31.208  control-hub.<username>.olares.com
192.168.31.208  profile.<username>.olares.com
192.168.31.208  vault.<username>.olares.com
# Add other community apps as needed
192.168.31.208  <entrance_id>.<username>.olares.com
  4. Save the file to apply changes and ensure local access without an internet connection.

Verify the changes by checking the URL for quick loading or using the terminal:

bash
ping desktop.<username>.olares.com

If the IP address starts with 192.168, it indicates successful configuration.

Learn more ​

FAQs ​

Why doesn't LarePass VPN work on my Mac anymore? ​

If you successfully enabled the VPN previously, but it has stopped working, you might need to reset the system extension.

INFO

Depending on your macOS version, the UI might look slightly different.

  1. Open System Settings, search for "Extension", and select Login Items & Extensions.
  2. Scroll to the Network Extensions section and click the info icon (ⓘ) to view loaded extensions.
  3. Find LarePass, click the three dots (...), and select Delete Extension.
  4. Confirm the uninstallation.
  5. Restart your Mac and re-enable the VPN in the LarePass desktop client.

Why I cannot enable LarePass VPN on Windows? ​

Third-party antivirus software might mistakenly flag the LarePass desktop client as suspicious, preventing it from launching the VPN service.

If prompted by your antivirus when opening LarePass for the first time, allow the application to continue.

If the VPN still fails to enable:

  1. Open your security software and check if LarePass was blocked.
  2. Add the main LarePass executable to the allowlist** or exclusions of your antivirus.
  3. Restart LarePass and enable the VPN.

Why the .local domain does not work in Chrome (macOS)? ​

Chrome may fail to access local URLs if macOS blocks local network permissions. To enable access:

  1. Open Apple menu and go to System Settings.

  2. Go to Privacy & Security > Local Network.

  3. Find Google Chrome and Google Chrome Helper in the list and enable the toggles. Enable local network

  4. Restart Chrome and try accessing the local URL again.

Why does the application fail to load in an iFrame when using a .local domain on Chrome (macOS)? ​

Chrome might default to HTTPS when using local domains, and you might see a "connection not secure" warning. Incorrect local address

To address this, explicitly add the HTTP protocol (http://) to the beginning of the URL. This tells Chrome it's a local, non-encrypted connection, which is expected on your home network.