Getting started

Install with Docker ComposeCopy Anchor Link

Clone the repository (it's private for now, so you need access) and create a .env file next to compose.yaml with three keys:

git clone <repo-url> palui
cd palui
openssl rand -base64 32   # run twice: once for MASTER_KEY, once for BETTER_AUTH_SECRET

MASTER_KEY=<output of openssl rand -base64 32>
BETTER_AUTH_SECRET=<a second output of openssl rand -base64 32>
APP_URL=https://palui.example.com

APP_URL is the public origin of your dashboard. Save a copy of MASTER_KEY in your password manager: every connector secret is encrypted with it, and a backup is useless without it.

Then build and start both services:

docker compose up -d --build --wait

--wait returns once both services are healthy, and fails if either doesn't come up. See Self-hosting for what the two services do.

Create the ownerCopy Anchor Link

Sign-up is disabled. The only way in is a single-use invite from the CLI:

docker compose exec app palui owner invite

It prints a link that works once and expires after 15 minutes. Open it and register a passkey. The dashboard lives at /app (for example https://palui.example.com/app). Run the same command again if you ever lose your passkey.

Connect a modelCopy Anchor Link

Open the Saklar page in the dashboard and add a model connector: CLIProxyAPI or ai-gateway. The base URL defaults to a service on the Docker host (http://host.docker.internal:8317 for CLIProxyAPI). Paste the API key and press Test. A working connector shows its model list.

Connect TelegramCopy Anchor Link

1. Create a bot with @BotFather (/newbot) and copy the token.
2. Add the Telegram connector, paste the token and press Test. It shows the bot's @bot_username.
3. The wizard shows a t.me link (and a QR code) with a one-time nonce. Open it on your phone and press Start. The nonce is single use and expires after 10 minutes.

The wizard waits with a live status line until your /start arrives. From then on, your Telegram account is the owner on that channel.

Send the first messageCopy Anchor Link

Send "halo" to your bot on Telegram. Or skip the phone: open Chats in the dashboard and use the "Palui (web)" chat.

Try a reminder next: "ingetin minum air 10 menit lagi" (remind me to drink water in 10 minutes). The reply echoes the time it understood.