Federated micro-blogging platform and content subscription service.
Built on ActivityPub protocol, self-hosted, lightweight. Part of the Fediverse.
Subscriptions provide a way to receive monthly payments from subscribers and to publish private content made exclusively for them.
Supported payment methods:
Other features:
- Sign-in with a wallet.
- Donation buttons.
- Token-gated registration (can be used to verify membership in some group or to stop bots).
- Converting posts into NFTs.
- Saving posts to IPFS.
Demo instance: https://public.mitra.social/ (invite-only)
Network stats: https://the-federation.info/mitra
Matrix chat: #mitra:halogen.city
Server: https://codeberg.org/silverpill/mitra (this repo)
Web client: https://codeberg.org/silverpill/mitra-web
Ethereum contracts: https://codeberg.org/silverpill/mitra-contracts
- Rust 1.54+ (when building from source)
- PostgreSQL 12+
- IPFS node (optional, see guide)
- Ethereum node (optional)
- Monero node and Monero wallet (optional)
Run:
cargo build --release --features production
This command will produce two binaries in target/release
directory, mitra
and mitractl
.
Install PostgreSQL and create the database:
CREATE USER mitra WITH PASSWORD 'mitra';
CREATE DATABASE mitra OWNER mitra;
Create configuration file by copying contrib/mitra_config.yaml
and configure the instance. Default config file path is /etc/mitra/config.yaml
, but it can be changed using CONFIG_PATH
environment variable.
Start Mitra:
./mitra
An HTTP server will be needed to handle HTTPS requests and serve the frontend. See the example of nginx configuration file.
Building instructions for mitra-web
frontend can be found at https://codeberg.org/silverpill/mitra-web#project-setup.
To run Mitra as a systemd service, check out the systemd unit file example.
Download and install Mitra package:
dpkg -i mitra.deb
Install PostgreSQL and create the database:
CREATE USER mitra WITH PASSWORD 'mitra';
CREATE DATABASE mitra OWNER mitra;
Open configuration file /etc/mitra/config.yaml
and configure the instance.
Start Mitra:
systemctl start mitra
An HTTP server will be needed to handle HTTPS requests and serve the frontend. See the example of nginx configuration file.
Install Monero node or choose a public one.
Configure and start monero-wallet-rpc daemon.
Create a wallet for your instance.
Add blockchain configuration to blockchains
array in your configuration file.
Install Ethereum client or choose a JSON-RPC API provider.
Deploy contracts on the blockchain. Instructions can be found at https://codeberg.org/silverpill/mitra-contracts.
Add blockchain configuration to blockchains
array in your configuration file.
See CONTRIBUTING.md
docker-compose up -d
Test connection:
psql -h localhost -p 55432 -U mitra mitra
(this step is optional)
docker-compose --profile monero up -d
Create config file, adjust settings if needed:
cp config.yaml.example config.yaml
Compile and run service:
cargo run
cargo run --bin mitractl
cargo clippy
cargo test
See FEDERATION.md
Most methods are similar to Mastodon API, but Mitra is not fully compatible.
mitractl
is a command-line tool for performing instance maintenance.
Monero: 8Ahza5RM4JQgtdqvpcF1U628NN5Q87eryXQad3Fy581YWTZU8o3EMbtScuioQZSkyNNEEE1Lkj2cSbG4VnVYCW5L1N4os5p