Skip to main content
You need Docker installed for the recommended path. For the Node.js path you need Node.js >= 20 and a running Redis instance.
1

Clone the repository

git clone https://github.com/rajnandan1/kener.git
cd kener
2

Set required environment variables

Open docker-compose.yml and update the two required values before the first run:
environment:
  KENER_SECRET_KEY: replace_me_with_a_random_string  # openssl rand -base64 32
  ORIGIN: http://localhost:3000                       # public URL of your instance
  REDIS_URL: redis://redis:6379
Set KENER_SECRET_KEY to a strong random string and ORIGIN to your public URL before starting for the first time. These values are used for CSRF protection and session signing and cannot be changed without logging all users out.
3

Start Kener

docker compose up -d
For Node.js, create a .env file in the project root first:
KENER_SECRET_KEY=replace_with_a_random_string
ORIGIN=http://localhost:3000
REDIS_URL=redis://localhost:6379
PORT=3000
To start a Redis instance locally for the Node.js path:
docker run -d --name kener-redis -p 6379:6379 redis:7-alpine
4

Open Kener

Navigate to http://localhost:3000. You will see the setup wizard on the first launch — follow it to create your admin account.
5

Access the admin dashboard

After creating your account, go to http://localhost:3000/manage to reach the admin dashboard. From here you can:
  • Add monitors (Monitors → Add Monitor)
  • Create a status page (Pages → New Page)
  • Set up notification channels (Alerts)
  • Invite team members (Settings → Users)

​
Next steps

Docker deployment

Production Compose setup with PostgreSQL, MySQL, and volume mounts

Environment variables

Full reference for all configuration options

Monitor types

API, Ping, TCP, DNS, SSL, SQL, Heartbeat, and more

API Reference

Automate Kener with the REST API

Build docs developers (and LLMs) love

Get started for freeTalk to us