YAIF (Yet another Iceshrimp fork) bringing you a lot of nonsense fixes, features & bugs you didn't know you needed since 2024 (this is a mirror of iceshrimp.dev/crimekillz/trashposs)
Go to file
ThatOneCalculator 9c4d6e2597 feat: dialog to remove follower
co-authored-by: atsu1125 <atsu1125@github>
2023-02-04 12:46:48 -08:00
.config TWA/assetlinks support 2023-01-21 12:55:38 -08:00
.okteto ok-to-test with okteto (#8799) 2022-06-09 00:50:23 +09:00
.vim no more eslint 2023-01-12 20:54:33 -08:00
.vscode vscode: replace eslint with rome 2023-01-14 14:33:15 +01:00
.woodpecker Merge branch 'develop' 2023-02-01 13:10:47 -08:00
chart Always signToActivityPubGet 2022-08-22 23:44:25 -07:00
custom Rework custom behaviour 2022-11-29 23:08:37 +01:00
cypress no more eslint 2023-01-12 20:54:33 -08:00
dev postgres: revert to 12.2 version 2022-12-19 02:57:51 +02:00
issue_template lavaforge --> codeberg until lavaforge is ready 2023-01-19 16:18:17 -08:00
locales feat: dialog to remove follower 2023-02-04 12:46:48 -08:00
packages feat: dialog to remove follower 2023-02-04 12:46:48 -08:00
scripts refactor: 🔨 Use pnpm instead of yarn (#9461) 2023-01-13 04:18:16 +00:00
.dockerignore refactor: 🔨 Use pnpm instead of yarn (#9461) 2023-01-13 04:18:16 +00:00
.editorconfig Use tabs in json 2017-05-24 20:27:39 +09:00
.gitattributes MisskeyRoom (#5267) 2019-08-18 14:41:33 +09:00
.gitignore styling 2023-02-01 11:51:19 -08:00
.node-version Update .node-version 2022-06-06 21:01:00 +09:00
.vsls.json Add .vsls.json 2018-08-13 00:24:45 +09:00
CALCKEY.md refactor: 🎨 rome 2023-01-12 20:40:33 -08:00
calckey.nginx.conf docs: 📝 improve documentation, nginx 2022-11-15 20:16:50 -08:00
CHANGELOG.md update changelog 2023-02-04 02:41:04 +01:00
cliff.toml fix: Header of cliff.toml changed to automatically link to calckey.md 2023-01-04 16:36:58 +00:00
CODE_OF_CONDUCT.md Add contact method 2022-12-12 22:03:22 -08:00
CONTRIBUTING.md refactor: 🔨 Use pnpm instead of yarn (#9461) 2023-01-13 04:18:16 +00:00
COPYING Add Calckey copyright 2022-12-13 20:23:58 +01:00
cypress.config.ts update cypress 2022-06-11 15:53:45 +09:00
docker-compose.yml postgres: revert to 12.2 version 2022-12-19 02:57:51 +02:00
docker-README.md refactor: 🔨 Use pnpm instead of yarn (#9461) 2023-01-13 04:18:16 +00:00
Dockerfile no more eslint 2023-01-12 20:54:33 -08:00
gulpfile.js Rework custom behaviour 2022-11-29 23:08:37 +01:00
LICENSE Use AGPLv3 2018-03-28 22:56:28 +09:00
package.json tag: 🔖 13.1.1 2023-02-04 04:23:44 +00:00
patrons.json chore: update patrons 2023-01-15 15:16:51 -08:00
pnpm-lock.yaml fix lock 2023-02-01 13:04:23 -08:00
pnpm-workspace.yaml refactor: 🔨 Use pnpm instead of yarn (#9461) 2023-01-13 04:18:16 +00:00
Procfile Create Procfile 2019-04-05 18:17:30 +09:00
README.md Update 'README.md' 2023-02-01 22:18:54 +00:00
release.json improve release notes 2023-02-01 11:14:16 -08:00
rome.json refactor: 🎨 rome 2023-01-12 20:40:33 -08:00
SECURITY.md minor spelling mistake 2022-12-13 17:33:50 +00:00
title_float.svg refactor: rm .github folder 2022-12-16 10:44:09 -08:00

Calckey logo

🌎 Calckey is an open source, decentralized social media platform that's free forever! 🚀

no github badge status badge liberapay badge translate-badge docker badge Contributor Covenant Codeberg badge

Calc (the Calckey mascot) smoking a fat dart

About Calckey

  • Calckey 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!
  • Calckey adds many quality of life changes and bug fixes for users and instance admins alike.
  • Read this document all for current and future differences.
  • Notable differences:
    • Improved UI/UX (especially on mobile)
    • Improved notifications
    • Fediverse account migration
    • Improved instance security
    • Improved accessibility
    • Recommended Instances timeline
    • OCR image captioning
    • New and improved Groups
    • Better intro tutorial
    • Many more user and admin settings
    • So much more!

🥂 Links

🌠 Getting started

This guide will work for both starting from scratch and migrating from Misskey.

🔰 Easy installers

If you have access to a server that supports one of the sources below, I recommend you use it! Note that these methods won't allow you to migrate from Misskey without manual intervention.

Install on Ubuntu  Install on the Arch User Repository  Install Calckey with YunoHost

🐋 Docker

How to run Calckey with Docker.

🧑‍💻 Dependencies

  • 🐢 At least NodeJS v18.12.1 (v19 recommended)
    • Install with nvm
  • 🐘 At least PostgreSQL v12
  • 🍱 At least Redis v6 (v7 recommend)

😗 Optional dependencies

  • FFmpeg for video transcoding
  • ElasticSearch for full-text search
    • OpenSearch/Sonic are not supported as of right now
  • Management (choose one of the following)
    • 🛰️ pm2
    • 🐳 Docker
    • Service manager (systemd, openrc, etc)

🏗️ Build dependencies

  • 🦬 C/C++ compiler & build tools
    • build-essential on Debian/Ubuntu Linux
    • base-devel on Arch Linux
  • 🐍 Python 3

👀 Get folder ready

git clone --depth 1 https://codeberg.org/calckey/calckey.git
cd calckey/
# git checkout main # if you want only stable versions

📩 Install dependencies

# nvm install 19 && nvm use 19
corepack enable
corepack prepare pnpm@latest --activate
# To build without TensorFlow, append --no-optional
pnpm i # --no-optional

🐘 Create database

Assuming you set up PostgreSQL correctly, all you have to run is:

psql postgres -c "create database calckey with encoding = 'UTF8';"

💅 Customize

  • To add custom CSS for all users, edit ./custom/assets/instance.css.
  • To add static assets (such as images for the splash screen), place them in the ./custom/assets/ directory. They'll then be available on https://yourinstance.tld/static-assets/filename.ext.
  • To add custom locales, place them in the ./custom/locales/ directory. If you name your custom locale the same as an existing locale, it will overwrite it. If you give it a unique name, it will be added to the list. Also make sure that the first part of the filename matches the locale you're basing it on. (Example: en-FOO.yml)
  • To update custom assets without rebuilding, just run pnpm run gulp.

🧑‍🔬 Configuring a new instance

  • Run cp .config/example.yml .config/default.yml
  • Edit .config/default.yml, making sure to fill out required fields.
  • Also copy and edit .config/docker_example.env to .config/docker.env if you're using Docker.

🚚 Migrating from Misskey to Calckey

⚠️ Because of their changes, migrating from Foundkey is not supported.

cp ../misskey/.config/default.yml ./.config/default.yml # replace `../misskey/` with misskey path, add `docker.env` if you use Docker
cp -r ../misskey/files .

🍀 NGINX

  • Run sudo cp ./calckey.nginx.conf /etc/nginx/sites-available/ && cd /etc/nginx/sites-available/
  • Edit calckey.nginx.conf to reflect your instance properly
  • Run sudo cp ./calckey.nginx.conf ../sites-enabled/
  • Run sudo nginx -t to validate that the config is valid, then restart the NGINX service.

🚀 Build and launch!

🐢 NodeJS + pm2

git pull and run these steps to update Calckey in the future!

# git pull
NODE_ENV=production pnpm install && pnpm run build && pnpm run migrate
pm2 start "NODE_ENV=production pnpm run start" --name Calckey

😉 Tips & Tricks

  • When editing the config file, please don't fill out the settings at the bottom. They're designed only for managed hosting, not self hosting. Those settings are much better off being set in Calckey's control panel.
  • Port 3000 (used in the default config) might be already used on your server for something else. To find an open port for Calckey, run for p in {3000..4000}; do ss -tlnH | tr -s ' ' | cut -d" " -sf4 | grep -q "${p}$" || echo "${p}"; done | head -n 1. Replace 3000 with the minimum port and 4000 with the maximum port if you need it.
  • I'd recommend you use a S3 Bucket/CDN for Object Storage, especially if you use Docker.
  • I'd strongly recommend against using CloudFlare, but if you do, make sure to turn code minification off.
  • For push notifications, run npx web-push generate-vapid-keys, then put the public and private keys into Control Panel > General > ServiceWorker.
  • For translations, make a DeepL account and generate an API key, then put it into Control Panel > General > DeepL Translation.
  • To add another admin account:
    • Go to the user's page > 3 Dots > About > Moderation > turn on "Moderator"
    • Go back to Overview > click the clipboard icon next to the ID
    • Run psql -d calckey (or whatever the database name is)
    • Run UPDATE "user" SET "isAdmin" = true WHERE id='999999'; (replace 999999 with the copied ID)
    • Have the new admin log out and log back in