Configuration
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:
- Open the app's detail view
- Open the inspector sidebar by clicking the button in the menu bar, or pressing ⌘I
- 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.
- Open the app's detail view
- Open the inspector sidebar by clicking the button in the menu bar, or pressing ⌘I
- Set the memory limit in megabytes (minimum 128 MB)
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:
- Open the app's detail view
- Open the inspector sidebar by clicking the button in the menu bar, or pressing ⌘I
- Find the environment variable you want to change
- Enter the new value
Variables are organized by category:
| Category | Description |
|---|---|
| Required | Must have a value for the app to run |
| Optional | Enhance functionality but aren't essential |
| Advanced | For 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.