Get Started

Configuration

Customize environment variables, ports, and resource limits for your apps.

Most apps work perfectly with their default settings. When you need to customize something, Lawn provides a straightforward settings interface — no config files required.

Install-Time Configuration

Some apps require configuration during installation. These are marked in the install sheet with a Configuration section. Common examples include:

  • Admin password — Your login credentials for the app
  • API tokens — Access keys for external service integration

Generated secrets (like database passwords) are created automatically — you don't need to come up with your own.

Ports

Each app that provides a web UI is assigned a port automatically. You can change this if needed:

  1. Open the app's detail view
  2. Open the inspector sidebar by clicking the button in the menu bar, or pressing ⌘I
  3. Enter your preferred port number

Resource Limits

You can adjust how much memory an app is allowed to use. This is useful when an app needs more resources than the default, or when you want to balance resources across multiple apps.

  1. Open the app's detail view
  2. Open the inspector sidebar by clicking the button in the menu bar, or pressing ⌘I
  3. Set the memory limit in megabytes (minimum 128 MB)
Changes to ports, environment variables, or resource limits may require an app restart to take effect.

Environment Variables

Environment variables are settings that control how an app behaves — things like which port to use, where to store data, or whether to enable specific features. Each app exposes different settings depending on what it supports.

To view or edit environment variables:

  1. Open the app's detail view
  2. Open the inspector sidebar by clicking the button in the menu bar, or pressing ⌘I
  3. Find the environment variable you want to change
  4. Enter the new value

Variables are organized by category:

CategoryDescription
RequiredMust have a value for the app to run
OptionalEnhance functionality but aren't essential
AdvancedFor fine-tuning — most users can ignore these

Some variables are set automatically during installation (like generated database passwords) and don't need to be changed.