# Kittygram

> Self-hosted, open-source Instagram browsing proxy in the spirit of Nitter, with themes, Valkey caching and optional Atom feeds.

- **Category:** [Social Networks & Forums](https://selfhost.directory/social-networks-forums)
- **Licence:** AGPL-3.0
- **Source model:** Open source
- **Latest version:** v1.2.0
- **Author:** Irelephant
- **Platforms:** Docker Compose, Podman
- **Ports:** 80 (Web UI served by OpenResty; the compose file publishes it as 8080:80 on the host)
- **Requires:** Redis or Valkey
- **Tags:** Redis, Privacy, GraphQL, Atom, Lua, Instagram, Valkey, Nitter, Openresty

## 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.

## Should you self-host Kittygram?

Kittygram scores **53/100** on selfhost.directory ([how scoring works](https://selfhost.directory/scoring)) and ranks **#44 of 75** in [Social Networks & Forums](https://selfhost.directory/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](https://selfhost.directory/project/mastodon) (84/100, 50 557 stars). It scores higher overall, so compare the two before you pick. [See Kittygram vs Mastodon side by side.](https://selfhost.directory/compare/kittygram-vs-mastodon)

## Features

- Anonymous browsing without tracking
- Atom feeds for users (◐ partial) — Off by default because of the concerns raised in a bibliogram discontinuation post.
- Comments viewing
- Explore page
- JSON API with token auth
- Per-endpoint upstream proxies — HTTP 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

Requirements: 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](https://git-scm.org), [git-lfs](https://git-lfs.com) and
   [Docker](https://docs.docker.com/engine/install).

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

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

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

### Install Kittygram with Podman

Requirements: git, git-lfs, Podman and Podman Compose

```bash
git clone git@codeberg.org:irelephant/kittygram.git --depth=1 && cd kittygram && git lfs pull
podman-compose -p kittygram -f compose.yaml up -d
```

Note: Do not run Podman as root; if you hit DNS/network problems, switch the compose DNS to Podman native.

## Kittygram is a self-hosted alternative to

- [Instagram (official web interface)](https://selfhost.directory/alternative-to/instagram-official-web-interface)

## Kittygram alternatives

- [instagram-comment-to-dm](https://selfhost.directory/project/instagram-comment-to-dm): Self-hosted open-source Instagram comment-to-DM automation turning comments into private replies via Meta Graph API, with keyword campaigns and Stripe subscriptions. (compare: https://selfhost.directory/compare/instagram-comment-to-dm-vs-kittygram)
- [yitter](https://selfhost.directory/project/yitter): yitter is a self-hosted, open-source Twitter frontend in Python for browsing without JavaScript or tracking, using Redis caching and multiple auth tokens. (compare: https://selfhost.directory/compare/kittygram-vs-yitter)
- [priviblur](https://selfhost.directory/project/priviblur): Priviblur is a self-hosted, open-source Tumblr frontend that acts as a privacy proxy, letting you browse blogs without tracking, accounts, or JavaScript. (compare: https://selfhost.directory/compare/kittygram-vs-priviblur)
- [foldergram](https://selfhost.directory/project/foldergram): Foldergram is a self-hosted, open-source photo and video gallery that turns local folders into an Instagram-style feed with PWA support and SQLite indexing. (compare: https://selfhost.directory/compare/foldergram-vs-kittygram)
- [InstaAuto](https://selfhost.directory/project/insta-p8): Self-hosted Instagram automation on Vercel/Supabase — DM replies, comment-to-DM funnels, story interactions, AI fallbacks. No monthly fees. (compare: https://selfhost.directory/compare/insta-p8-vs-kittygram)
- [Redlib](https://selfhost.directory/project/redlib): Self-hosted open-source private front-end for Reddit written in Rust: all requests and media are proxied server-side, with no JavaScript, ads, or tracking. (compare: https://selfhost.directory/compare/kittygram-vs-redlib)
- [RSSHub](https://selfhost.directory/project/rsshub): RSSHub is a self-hosted, open-source RSS feed generator for 5,000+ sites. Run via Docker or deploy to cloud platforms. (compare: https://selfhost.directory/compare/kittygram-vs-rsshub)
- [quetre](https://selfhost.directory/project/quetre): Self-hosted, open-source alternative front-end for Quora that removes ads, tracking, and bloat with a lightweight, responsive interface, dark mode, and unofficial API. (compare: https://selfhost.directory/compare/kittygram-vs-quetre)

## More in Social Networks & Forums

- [Known](https://selfhost.directory/project/known): Idno is a self-hosted, open-source social publishing platform for personal blogs. It supports ActivityPub federation, Webmentions, Microformats2, and RSS feeds.
- [Ktistec](https://selfhost.directory/project/ktistec): Ktistec is a self-hosted, open-source ActivityPub server for individuals and small groups, written in Crystal with SQLite storage and a rich web UI.
- [Lemmy](https://selfhost.directory/project/lemmy): Self-hosted, open-source fediverse link aggregator and forum: federated communities, upvotes, threaded comments, mod logs. Built in Rust, deployed via Docker or Ansible.
- [Libervia](https://selfhost.directory/project/libervia): Libervia-web is a web-based interface for Libervia, a decentralized and federated communication platform based on XMPP. It provides features such as instant messaging, microblogging, file sharing, photo albums, events, and forums.
- [Libreddit](https://selfhost.directory/project/libreddit): Self-hosted, open-source private front-end for Reddit written in Rust that proxied all traffic server-side; it stopped working in 2023 and lives on as the Redlib fork.
- [lobsters-rails-project](https://selfhost.directory/project/lobsters-rails-project): Open-source, self-hosted Rails app for running your own link-aggregation and discussion community, with tags, invitations, and public moderation logs.
- [Loomfeed](https://selfhost.directory/project/loomfeed): Loomfeed is a self-hosted, open-source Reddit alternative where AI agents participate as first-class citizens with provenance tracking and epistemic status labels.
- [loops](https://selfhost.directory/project/loops): Self-hosted, open-source ActivityPub platform for short vertical videos with Following and For You feeds, comments, boosts and an OAuth 2.0 API.
- [lurker](https://selfhost.directory/project/lurker): Lurker is a self-hosted, open-source read-only Reddit client that renders well on mobile, respects system dark mode, and requires no Reddit account.
- [Mastodon](https://selfhost.directory/project/mastodon): Open-source self-hosted microblogging server that federates over ActivityPub, with chronological timelines, media posts, moderation tools and an OAuth2 REST API.
- [Masto-FE Standalone](https://selfhost.directory/project/masto-fe-standalone): Open-source, self-hosted fork of the Mastodon web frontend that runs against GoToSocial instances and keeps tokens and passwords only in browser local storage.
- [mbin](https://selfhost.directory/project/mbin): Self-hosted fediverse platform for content aggregation, voting, discussions and microblogging. Replaces Reddit with ActivityPub federation to Mastodon, Lemmy, PeerTube.

## Links

- [Homepage](https://codeberg.org/irelephant/kittygram)
- [Matrix room](https://matrix.to/#/#kittygram:private.coffee)

---
Source: https://selfhost.directory/project/kittygram