selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Codeberg
Kittygram logo

Self-host Kittygram

v1.2.0

Privacy-first Instagram frontend with prerendered pages

ReleaseOpen SourceAGPL-3.0
Docker ComposeCompose file & guide
sudo docker compose up
Updated3 weeks ago
Setup difficultyModerate
ThemeDark mode
Port
80 (Web UI served by OpenResty; the compose file publishes it as 8080:80 on the host)
Requires
Redis or Valkey

What is Kittygram?

Kittygram is a web frontend for Instagram that you run on your own server, so browsing happens through your instance rather than Instagram's tracker-heavy site. Every upstream request is made by Kittygram itself and the pages come back fully prerendered, giving visitors light HTML plus selectable themes instead of the official web app. It covers user profiles, posts, comments, search and the explore page, can expose Atom feeds for accounts, and ships a token-protected JSON API. Operator settings live in a Lua config file (or in container environment variables): default theme, DNS resolver, per-endpoint upstream proxies, cache lifetimes, rate-limit cooldowns and an optional HTTP fetch sidecar. The recommended route is the compose file in the repository, which builds an OpenResty-based image and pairs it with Valkey; Podman Compose and a native OpenResty plus Lapis install are also documented. Limits are real: Instagram throttles server-side traffic hard, which makes public instances difficult to operate, and stories cannot be viewed yet. Development happens on Codeberg under an AGPL-3.0 licence, with a community instance list kept in the repo.

Kittygram alternatives

All self-hosted alternatives to Instagram (official web interface) →

Should you self-host Kittygram?

Kittygram scores 53/100 on selfhost.directory (how scoring works) and ranks #44 of 75 in Social Networks & Forums.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. It is AGPL-3.0-licensed.

Its closest alternative on selfhost.directory is Mastodon (84/100, 50 557 stars). It scores higher overall, so compare the two before you pick. See Kittygram vs Mastodon side by side.

Features

  • Anonymous browsing without tracking
  • Atom feeds for usersOff by default because of the concerns raised in a bibliogram discontinuation post.
  • Comments viewing
  • Explore page
  • JSON API with token auth
  • Per-endpoint upstream proxiesHTTP proxies only, not SOCKS.
  • Prerendered HTML pages
  • Rate-limit cooldown handling
  • Response caching
  • Search
  • User profiles and posts

How to install Kittygram

Install Kittygram with Docker Compose

git, git-lfs and Docker
Environment variables
PORT, SECRET, DEFAULT_THEME, CODE_CACHE, NUM_WORKERS, ALLOW_JSON, ENABLE_ATOM, DISABLE_LOGGING, BASE_ATOM_PATH, RESOLVER, COOLDOWN_ON_RATELIMIT, RATELIMIT_WINDOW_SIZE, RATELIMIT_REQUEST_LIMIT, ABOUT_MESSAGE, REQUIRE_API_TOKEN, API_TOKEN_EXPIRE_LENGTH, USE_HTTP_SIDECAR, HTTP_SIDECAR_URL, HTTP_SIDECAR_PROXY, REDIS_HOST, REDIS_PORT
  1. Install git, git-lfs and Docker.

  2. Clone the repository, move to the kittygram folder, set up Git LFS, and start the container:

    git clone git@codeberg.org:irelephant/kittygram.git --depth=1 && cd kittygram && git lfs pull
    sudo docker compose up
    

Containers are the recommended way to run Kittygram; compose.yaml builds a local image and starts a valkey service.

How to configure Kittygram

  • PORT80Docker config: port the app listens on
  • SECRETDocker config: secret used to sign tokens
  • DEFAULT_THEMEautoDocker config: theme used by default

    values: auto, kittygram_light, kittygram_dark, catppuccin_latte, catppuccin_frappe, catppuccin_macchiato, catppuccin_mocha, gruvbox_dark, gruvbox_light, ferra, basic

  • CODE_CACHEonDocker config: whether Lua code caching is on

    values: on / off

  • NUM_WORKERS4Docker config: number of workers

More in Social Networks & Forums

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…