Accessing Apps

Opening an App

Every app with a web interface shows an Open in Browser button in its detail view and in the menu bar dropdown. Click it to open the app in your default browser.

Local Domain Names

Every running app gets a .local domain name automatically. A running Paperless instance becomes reachable at:

http://paperless.local

The hostname is derived from the instance name:

• Spaces and special characters become hyphens
• The name is lowercased
• Unicode characters are replaced with hyphens

For example, "My Paperless" becomes http://my-paperless.local.

Device support: Local domain names work on macOS, iOS, iPadOS, Android 12 and later, and Windows 10 (build 1903) and later.

Accessing via localhost

Available ports are accessible at localhost:<port>. For a web interface, use http://localhost:<port>. Find the available addresses in the app's detail view under Ports.

This is useful when:

• You're working directly on your Mac and prefer explicit ports
• A .local domain doesn't resolve on your device
• You need to configure a third-party tool that requires localhost

Port Assignments

Some apps need a specific port, such as port 53 for DNS. If another app or process is using a required port, Lawn marks it Unavailable and shows the owner when it can identify one. Other available ports can still work, so an app's web interface may open while its DNS service is unavailable.

If you need a specific port (for example, to match a bookmark or mobile app configuration), you can change it in the port configuration.

Multiple Containers

Some apps run multiple containers internally (for example, a web app with a database). Lawn handles the networking between containers automatically. You only interact with the main web UI — the supporting services work seamlessly in the background.