iceshrimp/README.md

3.7 KiB

Iceshrimp

Iceshrimp is a decentralized and federated social networking service, implementing the ActivityPub standard.
It was forked from Calckey Firefish (itself a fork of Misskey) in mid-2023, to focus on stability, performance and usability instead of new features.


Note This project is not inactive.

Most of our current development resources are going into the rewrite, to further our goal of increasing stability and performance.

This means that major changes to the JS codebase (this project), and especially to the database schema, are on hold for the time being. Bugs will of course still be fixed, and support is still available on the usual channels.

Once the rewrite is finished, there will be an easy upgrade path for existing Iceshrimp instances.


  • Highlighted changes:
    • First-class Mastodon client API support
    • Significantly improved database performance
    • Options to prune cached remote media automatically
    • Proper support for split domain deployments, both local and remote
    • So much more - Read the changelog to get an overview of all changes
  • Don't like the Web UI? We test our Mastodon-compatible API against the following clients:
  • Project goals:
    • No-nonsense bug fixes
    • QoL improvements
    • Better performance
    • Change of focus to actual community needs
    • Prioritization of user choice and configurability
  • Project anti-goals:
    • Flashy marketing
    • Commercialization of any kind
  • Documentation on installing (and updating) Iceshrimp using:
  • Documentation on migrating from Firefish, Foundkey and Misskey can be found here.
  • Want to sign up at an existing instance?
    • Check out FediDB or Fediverse Observer to get an overview of the instances that are out there.
    • Please note that we do not operate a "flagship instance", the only project-affiliated domain is iceshrimp.dev.
  • Want to donate to the project?
    • Our backend lead dev (zotan) is in need of a better laptop, as their current one does not have enough memory. You can contribute here. Any leftover money will be given to queers in need.
  • Need help or want to contribute? Join the matrix room!