Repository files navigation

Rustodon is anMastodon-compatiblefederated social microblogging server. It utilizesActivityPub tofederate with a constellation ofother servers, connecting their communities with yours.

You probably don't want to use this, yet. Federation is WIP, etc.

We currently have authentication, users, profiles, statuses, content warnings, actors and statuses published as both HTML and AS2, and timelines.Wedo not have a job system, status delivery, inboxes, outboxes, notifcations, mentions, post privacy, or account privacy.

If you want to work on making Rustodon feature-complete, check out theissue tracker! We're not just looking for Rust devs, either; CSS witches, documentarians, UI/UX aficionados, etc, are highly welcome 😃

You will need to install several base dependencies:

1. Rust. Make sure you have followed the official instructions regarding yourPATH variable.

   In the Rust development environment, all tools are installed to the ~/.cargo/bin directory, and this is where you will find the Rust toolchain, including rustc, cargo, and rustup.Accordingly, it is customary for Rust developers to include this directory in their PATH environment variable. During installation rustup will attempt to configure the PATH. Because of differences between platforms, command shells, and bugs in rustup, the modifications to PATH may not take effect until the console is restarted, or the user is logged out, or it may not succeed at all.If, after installation, running rustc --version in the console fails, this is the most likely reason.

2. Postgres. If you don't have a Postgres instance available, you can use the supplieddocker-compose configuration file to start an instance:

   docker-compose up -d

   The instance will be started in the background. The default usernameand password isrustodon. The corresponding connection string would be:

   export DATABASE_URL=postgres://rustodon:rustodon@localhost/rustodon

   On some operating systems, you may need to separately install the Postgres client library:
   • Debian/Ubuntu/etc:apt install libpq-dev
   • Arch:pacman -S postgresql-libs
3. SASS. To install, followthe official directions, and make sure thesass binary is somewhere in yourPATH.

Once you have installed these base components, you should runscripts/setup to install the remainder of the application dependencies.

To run the application once you have installed all dependencies, you should run either:

• cargo run: Runs just the server
• fors start: Runs the server and additional helper processes

Rustodon will launch onhttp://localhost:8000 by default; this can be overriden by settingcertain environment variables.

Federation requires that the application know where it's hosted, and (thanks to Webfinger) also forces us to serve over HTTPS. To get around this in a development environment, you can usengrok or a similar service. To make sure the app knows where it's serving from (used to compute, eg, AS2 UIDs), setDOMAIN in.env.

diesel database setup

cargo test --all

Thanks goes to these wonderful people (emoji key):

Erin Moon 📝🖋💻🤔🚧👀📖	Measly Twerp 💻🤔	David Yip 💻🤔	Gaelan D'costa 🚇🤔	Chris Zelenak 💻📖	Hugh 💻🎨🖋🤔	Moritz Heiber 📖📦🔧
iliana destroyer of worlds 💻	1011X 🚧	Christopher Silva 🚧💻	utam0k 🚧📦	dexamphetamine 💻🤔	ash lea 💻🤔🚧

This project follows theall-contributors specification. Contributions of any kind welcome!