2023-05-10 15:30:52 -06:00
|
|
|
# Calckey
|
|
|
|
Calckey is Fediverse "social media" software similar to Mastodon.
|
|
|
|
|
|
|
|
Below are some notes about a test installation setup.
|
|
|
|
|
|
|
|
https://calckey.org/
|
|
|
|
|
|
|
|
https://codeberg.org/calckey/calckey
|
|
|
|
|
|
|
|
|
|
|
|
# Dependencies
|
|
|
|
|
|
|
|
## Debian
|
|
|
|
Tested on Debian 11 (Stable/Bullseye).
|
|
|
|
|
2023-05-10 15:44:19 -06:00
|
|
|
Not using Docker or Elasticsearch.
|
|
|
|
|
|
|
|
Install some dependencies from Debian repos:
|
2023-05-10 15:30:52 -06:00
|
|
|
|
|
|
|
```
|
|
|
|
apt update
|
|
|
|
apt install build-essential curl python3 python-is-python3 postgresql \
|
2023-05-10 16:40:56 -06:00
|
|
|
ffmpeg nginx
|
2023-05-10 15:30:52 -06:00
|
|
|
|
|
|
|
apt install -t bullseye-backports redis
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## NodeJS
|
2023-05-10 16:25:13 -06:00
|
|
|
Calckey recommends using nvm to manage NodeJS versions. So run:
|
2023-05-10 15:30:52 -06:00
|
|
|
|
|
|
|
```
|
|
|
|
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
|
|
|
|
```
|
|
|
|
|
|
|
|
The log out/in or run:
|
|
|
|
|
|
|
|
```
|
|
|
|
export NVM_DIR="$HOME/.nvm"
|
|
|
|
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
|
|
|
|
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
|
|
|
|
```
|
|
|
|
|
|
|
|
Then install the right version of `npm` with `nvm`:
|
|
|
|
|
|
|
|
```
|
|
|
|
nvm install 19
|
|
|
|
nvm use 19
|
|
|
|
```
|
|
|
|
|
|
|
|
Confirm correct version is running:
|
|
|
|
|
|
|
|
```
|
|
|
|
node -v
|
|
|
|
```
|
|
|
|
|
|
|
|
|
2023-05-10 15:44:19 -06:00
|
|
|
# Download and Install
|
2023-05-10 16:07:52 -06:00
|
|
|
Thusly.
|
|
|
|
|
2023-05-10 15:30:52 -06:00
|
|
|
```
|
|
|
|
git clone https://codeberg.org/calckey/calckey
|
|
|
|
cd calckey/
|
2023-05-10 16:07:52 -06:00
|
|
|
```
|
2023-05-10 15:30:52 -06:00
|
|
|
|
2023-05-10 16:58:05 -06:00
|
|
|
The default branch is `main`.
|
|
|
|
If you want to do a different branch, check it out, ala:
|
|
|
|
|
|
|
|
```
|
|
|
|
git checkout remotes/origin/develop
|
|
|
|
```
|
|
|
|
|
|
|
|
|
2023-05-10 15:44:19 -06:00
|
|
|
Install calckey NodeJS dependencies:
|
2023-05-10 15:30:52 -06:00
|
|
|
```
|
2023-05-10 15:44:19 -06:00
|
|
|
corepack enable
|
|
|
|
corepack prepare pnpm@latest --activate
|
|
|
|
pnpm i
|
|
|
|
# pnpm i --no-optional # without Tensorflow. Downloads it anyway.
|
2023-05-10 15:30:52 -06:00
|
|
|
```
|
|
|
|
|
|
|
|
|
2023-05-10 16:06:09 -06:00
|
|
|
# Setup
|
2023-05-10 16:07:52 -06:00
|
|
|
Setup thusly.
|
2023-05-10 16:06:09 -06:00
|
|
|
|
|
|
|
## Postgres
|
|
|
|
Database creation (change username at end):
|
|
|
|
|
|
|
|
```
|
2023-05-10 16:58:05 -06:00
|
|
|
sudo -u postgres createuser --createdb --pwprompt debian
|
2023-05-10 16:06:09 -06:00
|
|
|
|
|
|
|
psql postgres -c "create database calckey with encoding = 'UTF8';"
|
|
|
|
```
|
|
|
|
|
|
|
|
|
2023-05-10 16:40:56 -06:00
|
|
|
## nginx
|
|
|
|
Setup web proxy.
|
|
|
|
|
|
|
|
```
|
|
|
|
sudo cp ./calckey.nginx.conf /etc/nginx/sites-available/
|
|
|
|
cd /etc/nginx/sites-available/
|
|
|
|
sudo $EDITOR calckey.nginx.conf
|
|
|
|
cd ../sites-enabled/
|
|
|
|
sudo ln -s ../sites-available/calckey.nginx.conf .
|
|
|
|
sudo nginx -t
|
|
|
|
sudo systemctl restart nginx
|
|
|
|
```
|
2023-05-10 16:25:13 -06:00
|
|
|
|
|
|
|
|
2023-05-10 16:40:56 -06:00
|
|
|
# Configure Calckey
|
|
|
|
Configure thusly.
|
2023-05-10 16:25:13 -06:00
|
|
|
|
2023-05-10 16:58:05 -06:00
|
|
|
Go back to the Calckey git directory cloned above.
|
|
|
|
|
2023-05-10 16:25:13 -06:00
|
|
|
```
|
|
|
|
cp .config/example.yml .config/default.yml
|
|
|
|
$EDITOR .config/default.yml
|
|
|
|
```
|
|
|
|
|
2023-05-10 16:40:56 -06:00
|
|
|
Set, like my example:
|
|
|
|
|
|
|
|
* `url: https://rs-calckey.jebba.moe/`
|
|
|
|
* `db user: debian` # and other needed db settings
|
|
|
|
|
|
|
|
|
2023-05-10 16:58:05 -06:00
|
|
|
# Build Calckey
|
|
|
|
Build thusly.
|
|
|
|
|
|
|
|
```
|
|
|
|
pnpm install
|
|
|
|
NODE_ENV=production pnpm run build
|
|
|
|
```
|
|
|
|
|
|
|
|
This will set up the database. If it fails here, check Postgres.
|
|
|
|
```
|
|
|
|
pnpm run migrate
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
# Run Calckey
|
|
|
|
Run thusly.
|
|
|
|
|
|
|
|
```
|
|
|
|
NODE_ENV=production pnpm run start
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
# Web
|
|
|
|
Go to Calckey using the url in `.config/default.yml`.
|
|
|
|
Example:
|
|
|
|
|
|
|
|
https://rs-calckey.jebba.moe
|
|
|
|
|
|
|
|
The first user you create will be the admin user.
|
|
|
|
|
2023-05-10 16:25:13 -06:00
|
|
|
|
2023-05-10 16:59:47 -06:00
|
|
|
![Calckey default inital screen.](img/calckey-www-default-1.png)
|
|
|
|
|
|
|
|
|
2023-05-10 15:30:52 -06:00
|
|
|
# Copyright
|
|
|
|
Unofficial project, not part of official Calckey software or
|
|
|
|
website. Upstream sources under their respective copyrights.
|
|
|
|
|
|
|
|
License: CC By SA 4.0 International and/or AGPLv3+ at your discretion.
|
|
|
|
|
|
|
|
*Copyright © 2023, Jeff Moe.*
|
|
|
|
|