Reference
Limits & environment
How many rows, how long they last, text lengths and environment variables.
Rows
| How many | 32 rows from your Mac, and 32 from each server. A new ID past that is still answered 200 but not shown. Updates to rows already there always go through. |
|---|---|
| Working, waiting | 900 s after the last call, or what --ttl says, from 0 to 86400 s (a day). |
| Done, failed | Until you’ve seen it on the bar, for up to 12 hours after it finished. --clear removes it at once. |
| Restarts | Rows live in Evlat’s memory and are gone when it restarts. |
Text
| ID | 1–64 characters: letters, digits, . _ -. |
|---|---|
| Label | Up to 80 characters; longer is cut. |
| Detail | Up to 200 characters; longer is cut. |
| Sender | Up to 24 characters; longer is cut. |
Control characters are dropped and line breaks become spaces.
Environment
| Variable | What it does |
|---|---|
EVLAT_SOCKET | The socket instead of ~/.config/evlat/run/evlat.sock, as an absolute path: for a second Evlat beside your own. The app listens there, and evlat signal and evlat watch post there. A relative path counts as no socket. |
EVLAT_HOME | The home folder the socket is found under. |
EVLAT_SANDBOX_PORT | The Docker sandbox listener’s port instead of 48152. With EVLAT_SOCKET set, Evlat has no sandbox listener unless this is given too. |
EVLAT_PORT | Gone. With it set, even empty, Evlat prints EVLAT_PORT is gone; use EVLAT_SOCKET and exits 2. evlat watch still runs your command and sends nothing; evlat signal sends nothing, prints that line and exits 1. Use EVLAT_SOCKET instead. |
Network
Evlat opens no network port for rows: it listens on a socket in a folder of your home that only you can enter. Requests from web pages (with an Origin header) are refused. A request waits at most 2 seconds; when nothing answers, the command carries on silently.