# LaraPaper

> Run the server behind your TRMNL e-ink displays.

- Page: https://cgt.octabyte.io/templates/larapaper/
- Category: Home & family
- Ease of use: Some setup. Create your account in the browser, then point your TRMNL or compatible e-ink device at your LaraPaper address during its Wi-Fi setup and pick its screens.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: MIT
- Good for: TRMNL owners and e-ink tinkerers who want their display's screens served from their own server
- Official website: https://usetrmnl.github.io/larapaper/
- Documentation: https://usetrmnl.github.io/larapaper/
- Source code: https://github.com/usetrmnl/larapaper
- Last updated: 2026-11-20

## What is LaraPaper?

LaraPaper is a self-hosted TRMNL server for TRMNL and compatible e-ink displays: manage your devices and pick the recipes and screens each one shows.

LaraPaper is a free, open-source, self-hosted TRMNL server (a TRMNL "BYOS", or bring-your-own-server): it takes the place of TRMNL's cloud service, so your TRMNL e-ink display, or a compatible DIY panel, e-reader or old phone, gets its screens from your own server. It is only for people who already have one of these devices.

From the web dashboard you see every display with its battery and Wi-Fi, then decide what each one shows: recipes imported from the TRMNL and community catalogs, a screenshot of a web page, a picture, or a layout you write yourself. Playlists rotate screens through the day. A family could hang a TRMNL in the hallway that shows train departures and the weather before school, then the shared calendar in the evening, with a refresh interval they choose for that device.

LaraPaper works with TRMNL OG and TRMNL X, Seeed Studio and other e-paper kits, and Kindle, Kobo, Nook, Android and Raspberry Pi clients. With a TRMNL Developer Edition licence, a device can also keep showing its TRMNL cloud plugins. It is a volunteer project built for one person or a trusted household.

Cloudgate installs LaraPaper on a server Cloudgate provides or one you connect and gives it a secure web address. You then create your account and point each device at that address.

## What you can do with LaraPaper

- **All your displays in one place**: See each device's current screen, battery level, Wi-Fi strength and firmware version on one dashboard.
- **Screens from recipes and plugins**: Show weather, calendars, quotes, train departures, Home Assistant data and more, using recipes you import from the TRMNL and community catalogs or write yourself.
- **Playlists for different times of day**: Rotate several screens on a device, for example train times in the morning and the family calendar in the evening.
- **Screenshots, images and your own designs**: Turn a web page into an e-ink screen, send a picture to a device, write your own layout, or push a screen from a script.
- **More than TRMNL hardware**: Works with TRMNL OG and TRMNL X, Seeed Studio and other DIY e-paper panels, and Kindle, Kobo, Nook, Android and Raspberry Pi clients.
- **Keep TRMNL cloud plugins too**: A device can show your own screens and fall back to its TRMNL cloud plugins, if it has a TRMNL Developer Edition licence.
- **Mirror one screen to another**: Let a second device show the same screen as the first, so two rooms stay in step.

## What happens when you click Deploy?

Deploy link: https://cloudgate.octabyte.app/get-started?template=larapaper

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. LaraPaper itself is free.
2. **Choose a server.** No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.
3. **Cloudgate sets up LaraPaper.** It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
4. **Open your app and sign in.** Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

## Questions

### Is LaraPaper free?

Yes. LaraPaper is free, open-source software under the MIT licence, with no paid edition. You pay only for the small server it runs on.

### Do I need a TRMNL device to use LaraPaper?

Yes, or a compatible display. LaraPaper is a server for TRMNL e-ink devices, DIY panels running TRMNL firmware such as the Seeed Studio kits, and e-readers, Android phones or a Raspberry Pi running a TRMNL client app. It has no use without one of these.

### How do I connect my TRMNL to my own LaraPaper server?

On firmware 1.4.6 or newer, choose Custom Server after entering your Wi-Fi details and type your LaraPaper web address. Older firmware has to be updated by flashing it first. You then add the device in LaraPaper's Devices page with its MAC address and API key, which the TRMNL dashboard shows.

### How do I sign in to LaraPaper the first time?

Open your LaraPaper web address and register; the first account becomes yours. Sign-up then closes, because LaraPaper is built for one person or a trusted household.

### Can I still use my TRMNL cloud plugins?

Yes, if your device has a TRMNL Developer Edition licence. LaraPaper can pass the device's cloud plugins through and show them whenever none of your own screens is scheduled.

### Can I use recipes from the TRMNL recipe catalog?

Yes. LaraPaper imports recipes from the TRMNL recipe catalog and from a community catalog of open-source recipes, though not every recipe works yet.

### Is LaraPaper made by TRMNL?

No. LaraPaper is a community project maintained by volunteer Benjamin Nussbaum. It lives in TRMNL's GitHub organisation, and TRMNL lists it among the community servers for running your own TRMNL backend.

### Do I need technical skills to run LaraPaper?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up LaraPaper and gives it a web address. You use it in your browser like any other online tool.

### Do I need my own server for LaraPaper?

No. When you deploy LaraPaper, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.
