A social networking server anyone can self-host
Go to file
Natty 0dff0c0785
ci/woodpecker/push/ociImagePush Pipeline is running Details
Implemented WebFinger flow and fixed incoming WebFinger
2024-04-01 01:34:27 +02:00
.cargo Undo an accidental commit of the linker setting 2023-11-03 19:56:29 +01:00
.dev Implemented host-meta and some overdue fixes 2024-03-31 05:10:48 +02:00
.woodpecker Fixed CI workflow 2024-01-03 20:58:28 +01:00
config Proxied images and user instance meta resolving 2023-11-05 15:23:48 +01:00
core Implemented WebFinger flow and fixed incoming WebFinger 2024-04-01 01:34:27 +02:00
ext_calckey_model Implemented WebFinger flow and fixed incoming WebFinger 2024-04-01 01:34:27 +02:00
ext_federation Implemented WebFinger flow and fixed incoming WebFinger 2024-04-01 01:34:27 +02:00
ext_host_meta Implemented WebFinger flow and fixed incoming WebFinger 2024-04-01 01:34:27 +02:00
ext_nodeinfo Experimental Calckey frontend serving 2023-07-07 21:22:30 +02:00
ext_webfinger Implemented WebFinger flow and fixed incoming WebFinger 2024-04-01 01:34:27 +02:00
fe_calckey Fixed follow list view pagination 2024-03-06 16:11:37 +01:00
magnetar_common Implemented WebFinger flow and fixed incoming WebFinger 2024-04-01 01:34:27 +02:00
magnetar_mmm_parser Fixed an edge case in strict flanking rules 2024-03-13 14:31:05 +01:00
magnetar_sdk Fixed notification filtering and a bunch of bugs 2024-02-29 00:27:19 +01:00
src Implemented WebFinger flow and fixed incoming WebFinger 2024-04-01 01:34:27 +02:00
.dockerignore Experimental Calckey frontend serving 2023-07-07 21:22:30 +02:00
.gitignore NodeInfo serde, basic config support, modularization 2023-02-26 03:31:39 +01:00
.noai Disable AI IDE features 2024-01-15 01:40:40 +01:00
Cargo.lock Implemented WebFinger flow and fixed incoming WebFinger 2024-04-01 01:34:27 +02:00
Cargo.toml Implemented host-meta and some overdue fixes 2024-03-31 05:10:48 +02:00
Dockerfile Fixed Dockerfile 2024-03-31 05:25:20 +02:00
LICENSE Added an AGPL LICENSE 2023-02-14 02:01:52 +01:00
README.md Added SQL migrations and bootstrapping 2023-07-29 05:20:00 +02:00

README.md

magnetar

Magnetar logo, an 8-pointed star with two symmetrical cones

A social networking server anyone can self-host

This project is in early development.

Quick start

  1. Create a Postgres database
  2. Create a Redis instance
  3. Configure the required options in config/default.toml
  4. Build Magnetar: cargo build --release --workspace --bins
  5. Build the Magnetar Calckey frontend: cd fe_calckey/frontend && pnpm install && pnpm run build
  6. Run Magnetar: ./target/release/magnetar
  7. Build and run a modified version of Calckey, pointed to the same database and Redis
  8. Start up the Magnetar frontend: ./target/release/magnetar_calckey_fe
  9. Set up a reverse proxy based on .dev/Caddyfile

Read further for additional information.

What's inside

Magnetar builds to two primary binaries:

  • magnetar -- The backend
  • magnetar_calckey_fe -- A web server hosting a self-contained frontend

The fe_calckey/frontend directory contains the Calckey-based web frontend.

Additional dependencies

Magnetar depends on a Postgres database, Redis instance, as well as a modified Calckey backend running in tandem.

Building

Magnetar can be built both as standalone binaries or OCI containers (Podman, Docker, ...).

Native

Building the Magnetar backend requires:

  • latest stable Rust toolchain

Building the included Magnetar/Calckey frontend requires:

  • latest stable Rust toolchain
  • Node.js and npm

Steps

  1. Build both the frontend and the backend binaries:
    cargo build --release --workspace --bins
    
  2. Switch to the frontend directory:
    cd fe_calckey/frontend
    
  3. Install the frontend dependencies:
    pnpm install
    
  4. Build the frontend
    pnpm run build
    

Container build

Magnetar can be built to a single monolithic OCI image using the provided Dockerfile, containing the Magnetar binaries.

podman build -t magnetar .
# or
docker build -t magnetar .

Running

Follow the steps from the "building" chapter.

Native setup

Debug builds can be run using cargo run --package magnetar --bin magnetar and run --package magnetar_calckey_fe --bin magnetar_calckey_fe.

Monolithic container image

Choose between the backend and frontend using the --entrypoint /magnetar/magnetar and --entrypoint /magnetar/magnetar_calckey_fe respectively.

Mount the directory in /magnetar/config to pass in configuration from the host machine. Alternatively, see the config/default.toml file and pass in corresponding environment variables.

Connecting all components

In order to connect all components of magnetar, a router/reverse proxy is necessary. See .dev/Caddyfile for a template configuration.