| .config | ||
| .gitlab | ||
| .vscode | ||
| chart | ||
| custom | ||
| dev | ||
| docs | ||
| locales | ||
| packages | ||
| scripts | ||
| .dockerignore | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| .weblate | ||
| animated.svg | ||
| biome.json | ||
| cliff.toml | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| COPYING | ||
| docker-compose.example.yml | ||
| Dockerfile | ||
| firefish.nginx.conf | ||
| gulpfile.js | ||
| LICENSE | ||
| package.json | ||
| patrons.json | ||
| pnpm-lock.yaml | ||
| pnpm-workspace.yaml | ||
| Procfile | ||
| README.md | ||
| release.json | ||
| SECURITY.md | ||
| title.svg | ||
🌎 Firefish is an open source, decentralized social media platform that's free forever! 🚀
Firefish is based off of Misskey, a powerful microblogging server on ActivityPub with features such as emoji reactions, a customizable web UI, rich chatting, and much more!
Links
Want to get involved? Great!
- If you have the means to, donations are a great way to keep us going.
- If you know how to program in TypeScript, Vue, or Rust, read the contributing document and our Developers' Corner .
- If you know a non-English language, translating Firefish on Weblate help bring Firefish to more people. No technical experience needed!
Links
- Donations:
- OpenCollective: https://opencollective.com/Firefish
- Matrix space: https://matrix.to/#/#firefish-community:nitro.chat
- Official account:
@firefish@info.firefish.dev - Weblate: https://hosted.weblate.org/engage/firefish/
Release cycle
We use a rolling release cycle now. Small updates will be frequently merged into the main branch, so please upgrade regularly at your convenience. We will use the commit date (e.g., 20240206) as the version number.
Any special operations required for an upgrade (e.g., installing new dependencies, editing docker-compose.yml) will be noted on docs/notice-for-admins.md , so please check it before upgrading.
As always, please take a backup first before starting update. Whether it is a server snapshot backup or a complete database and file backup, it will be of great help to your recovery process.
Getting started
This guide will work for both starting from scratch and migrating from Misskey.
Containerization
Install Production Environment
For install production environment details, read this document.
Dependencies
- At least NodeJS v18.17.0 (v20/v21 recommended)
- At least PostgreSQL v12 (v16 recommended) with PGroonga extension
- At least Redis v7
- Web Proxy (one of the following)
- Caddy (recommended for new users)
- Nginx (recommended)
- Apache
Optional dependencies
- FFmpeg for video transcoding
- Caching server (one of the following)
- DragonflyDB (recommended)
- KeyDB
- Another Redis server
Build dependencies
- At least Rust v1.74
- C/C++ compiler & build tools
build-essentialon Debian/Ubuntu Linuxbase-develon Arch Linux
- Python 3
Migrating from Misskey/FoundKey to Firefish
For migrating from Misskey v13, Misskey v12, and FoundKey, read this document.