Untils logo untils Docs
Sign in

Last updated 20 April 2026

Self-hosting quickstart

Self-hosting untils lets you run the full application stack on your own hardware. Some knowledge of server admin and Docker is expected.

If you'd prefer to use a hosted version, sign up to the waitlist on the home page and get notified when it's ready.

untils is still in development - rough edges and backwards-incompatible changes should be expected.

Find untils on Github: alexpls/untils.

Prerequisites

System

  • x86
  • Docker with docker compose
  • Enough RAM to comfortably run Google Chrome headless

External APIs

  • Brave Search API (quickstart)
  • LLM provider (OpenAI or x.ai API key)
  • (optional) Pushover app key for delivering push notifications (quickstart)
  • (optional) SMTP server for delivering emails

1. Download the compose and env files

Create a working directory, then download the self-hosting files from GitHub:

mkdir untils-selfhost
cd untils-selfhost
curl -O https://raw.githubusercontent.com/alexpls/untils/master/docker-compose.selfhosted.yml
curl -o .env.selfhosted https://raw.githubusercontent.com/alexpls/untils/master/.env.selfhosted.example

2. Edit .env.selfhosted

nano .env.selfhosted

Set the values for your deployment. The example file includes comments for each setting.

3. Start the stack

docker compose --env-file .env.selfhosted -f docker-compose.selfhosted.yml up -d

This starts the app, PostgreSQL, and the bundled browser service used for checks.

4. Sign in

Open:

http://localhost:3322/app

Sign in with:

  • Email: the ADMIN_EMAIL value
  • Password: abc123 (change that password immediately!)