Self-host Kittygram
v1.2.0Privacy-first Instagram frontend with prerendered pages
sudo docker compose up- 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
instagram-comment-to-dmSelf-hosted open-source Instagram comment-to-DM automation turning comments into private replies via Meta Graph API, with keyword campaigns and Stripe subscriptions.Compareinstagram-comment-to-dm with Kittygram
yitteryitter is a self-hosted, open-source Twitter frontend in Python for browsing without JavaScript or tracking, using Redis caching and multiple auth tokens.Compareyitter with Kittygram
priviblurPriviblur is a self-hosted, open-source Tumblr frontend that acts as a privacy proxy, letting you browse blogs without tracking, accounts, or JavaScript.Comparepriviblur with Kittygram
foldergramFoldergram 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.Comparefoldergram with Kittygram
InstaAutoSelf-hosted Instagram automation on Vercel/Supabase — DM replies, comment-to-DM funnels, story interactions, AI fallbacks. No monthly fees.CompareInstaAuto with Kittygram
RedlibSelf-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.CompareRedlib with Kittygram
RSSHubRSSHub is a self-hosted, open-source RSS feed generator for 5,000+ sites. Run via Docker or deploy to cloud platforms.CompareRSSHub with Kittygram
quetreSelf-hosted, open-source alternative front-end for Quora that removes ads, tracking, and bloat with a lightweight, responsive interface, dark mode, and unofficial API.Comparequetre with Kittygram
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
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_PORTContainers are the recommended way to run Kittygram; compose.yaml builds a local image and starts a valkey service.
More in Social Networks & Forums
KnownIdno is a self-hosted, open-source social publishing platform for personal blogs. It supports ActivityPub federation, Webmentions, Microformats2, and RSS feeds.
KtistecKtistec is a self-hosted, open-source ActivityPub server for individuals and small groups, written in Crystal with SQLite storage and a rich web UI.
LemmySelf-hosted, open-source fediverse link aggregator and forum: federated communities, upvotes, threaded comments, mod logs. Built in Rust, deployed via Docker or Ansible.- LiberviaLibervia-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.
LibredditSelf-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-projectOpen-source, self-hosted Rails app for running your own link-aggregation and discussion community, with tags, invitations, and public moderation logs.
LoomfeedLoomfeed is a self-hosted, open-source Reddit alternative where AI agents participate as first-class citizens with provenance tracking and epistemic status labels.
loopsSelf-hosted, open-source ActivityPub platform for short vertical videos with Following and For You feeds, comments, boosts and an OAuth 2.0 API.
lurkerLurker is a self-hosted, open-source read-only Reddit client that renders well on mobile, respects system dark mode, and requires no Reddit account.
MastodonOpen-source self-hosted microblogging server that federates over ActivityPub, with chronological timelines, media posts, moderation tools and an OAuth2 REST API.
Masto-FE StandaloneOpen-source, self-hosted fork of the Mastodon web frontend that runs against GoToSocial instances and keeps tokens and passwords only in browser local storage.
mbinSelf-hosted fediverse platform for content aggregation, voting, discussions and microblogging. Replaces Reddit with ActivityPub federation to Mastodon, Lemmy, PeerTube.
0 comments