Skip to content
This repository has been archived by the owner on Aug 11, 2020. It is now read-only.

Commit

Permalink
add missing gcc compilers
Browse files Browse the repository at this point in the history
Update docs
  • Loading branch information
alexwennerberg committed Jun 15, 2020
1 parent 579d7a5 commit a5e66f8
Show file tree
Hide file tree
Showing 3 changed files with 40 additions and 15 deletions.
12 changes: 7 additions & 5 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -13,9 +13,10 @@ jobs:
matrix:
build-target:
- "x86_64-unknown-linux-gnu"
- "x86_64-apple-darwin"
- "x86_64-pc-windows-gnu"
- "armv7-unknown-linux-gnueabihf" # Some versions of rasp pi"
- "x86_64-unknown-linux-musl"
# - "x86_64-apple-darwin" broken
# - "x86_64-pc-windows-gnu" broken
# - "armv7-unknown-linux-gnueabihf" # broken...
steps:
- uses: actions-rs/toolchain@v1
with:
Expand All @@ -24,14 +25,15 @@ jobs:
target: ${{ matrix.build-target }}
- uses: actions/checkout@v2
- name: Install sqlite
run: sudo apt-get update && sudo apt-get install sqlite3 libsqlite3-dev
# TODO split out or use cross
run: sudo apt-get update && sudo apt-get install sqlite3 libsqlite3-dev musl musl-tools
- name: build
run: cargo build --release --features="vendored-openssl" --target=${{matrix.build-target}}
- name: Upload binaries to release
uses: svenstaro/upload-release-action@v1-release
with:
repo_token: ${{ secrets.GITHUB_TOKEN }}
file: target/${{matrix.build-target}}/gourami
file: target/${{matrix.build-target}}/release/gourami
asset_name: gourami-${{matrix.build-target}}
tag: ${{ github.ref }}
overwrite: true
37 changes: 30 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,11 @@ An intentionally small, community-focused ultra-lightweight decentralized social

## Philosophy and Design

Gourami differs from existing social networks in a number of ways:
Gourami is...
* **Intentionally small** -- designed to support 50-100 active users. I'm sure it could support more, but things could quickly become a mess. Gourami was hugely and directly inspired by the fantastic essay on [runyourown.social](https://runyourown.social). Gourami is designed to support relatively small communities, maybe tied to a specific interest, community, or physical location.
* **Decentralized** -- Gourami uses [ActivityPub](https://activitypub.rocks/) to connect separate servers, but with an implementation that differs from existing ActivityPub servers such as Mastodon. Instances federate at the server level, rather than the user level, which means all users on the server share the same "neighborhood".
* **Invite-only and closed** -- a community curated by the server admin, rather than open to all. Server-local posts are private.
* **Community, rather than user focused** -- All users share the same timeline(s), and ActivityPub federation occurs on the server, rather than user level. This is somewhat different than how most ActivityPub servers work, and focuses on privacy, community, and locality over easily-shareable public content. This may change if users are interested in a more conventional AP implementation, but I thought it'd be interesting to experiment with a different model for federation.
* **Decentralized** -- Gourami uses [ActivityPub](https://activitypub.rocks/) to federate separate instances, so communities can communicate between instances.
* **Invite-only and private** -- a community curated by the server admin, rather than open to all. Server-local posts are private.
* **Community, rather than user focused** -- All users share the same timeline(s), and ActivityPub federation occurs on the server, rather than user level. This is somewhat different than how most ActivityPub servers work, and focuses on privacy, community, and locality over easily-shareable public content.
* **Free and open source** -- Gourami is 100% free and open source, licensed under [AGPL v3](LICENSE).
* **A social network with physical context** -- Gourami should be easy to deploy in a physical space (such as a home, apartment building, coffee shop or [wireless mesh network](https://www.nycmesh.net/)) or among people in a specific physical community, such as a university or town. In *How to Do Nothing*, Jenny Odell discusses the lack of a context, specifically physical and temporal context, in social media, and calls for social networks that are tied to physical space. While Gourami does not force you to tie a deployment to a place, it is designed in such a way that such a deployment would be relatively easy.
* **Extremely lightweight & fast** -- very little Javascript, plain text, small page sizes. Should run on extremely lightweight/cheap hardware and low-bandwidth networks.
Expand All @@ -28,11 +28,31 @@ Gourami differs from existing social networks in a number of ways:

*Features that aren't implemented yet:*

* **Mastodon/other AP server interop** -- Gourami manages identities in a somewhat different way than Mastodon and other ActivityPub microblogging services. I have experimented with Mastodon interop and it works to some degree, but I don't want to officially support it until it's more stable. It's currently disabled.
* **Mastodon/other AP server interop** -- WIP, with the caveats in the next section.

## Gourami is not (really) part of the "Fediverse"

The Fediverse is a public network of servers that communicate mostly publicly on the open internet. There are advantages to this model, but also disadvantages:

* For the average user, not ideologically motivated, it isn't *that* much different than Twitter, except in terms of the userbase.
* Spam and abuse are constant battles.
* Due to the above and other factors, the Fediverse has tended towards centralization in practice.

Gourami is not anti-fediverse, but it follows a fundamentally different model for decentralization:

* Servers are networked with servers, rather than users with users
* Each server whitelists a small number of servers to federate with
* All posts are shared either to the local instance, or to the neighborhood instances. Nothing is public.

Gourami's model of federation is meant to decentralize not just on the level of architecture, but also on a social level -- where there is no central "fediverse" everyone participates in, but rather your server and the servers you choose to federate with. Gourami intends to mimic real world, physical communities, where a sense of place is restored.

Interop with other ActivityPub microblogging services is still a goal, but the manner in which servers network together is different than how Mastodon or other services.

## Local Installation

I'm working on pre-built binaries. You can find them at the [releases](https://github.com/alexwennerberg/gourami/releases) page. Right now there's just a single binary built on ubuntu -- I'll add support for other platforms soon
If you're on a Linux environment, the easiest way to get started is with the precompiled binaries. You can find them at the [releases](https://github.com/alexwennerberg/gourami/releases) page.

If you want to build Gourami yourself --

Make sure you have the following dependencies:

Expand All @@ -47,7 +67,9 @@ Clone this repository with `git clone https://github.com/alexwennerberg/gourami`

Run `cargo install --path .`

Configuration is done via [dotenv](https://github.com/dotenv-rs/dotenv). For development and testing, the `sample_env` file is good to get started -- copy it to `.env` in the same directory that you're running gourami.
### Configuration & getting started

Configuration is done via [dotenv](https://github.com/dotenv-rs/dotenv). For development and testing, the `sample_env` file is good to get started for local testing -- copy it to `.env` in the same directory that you're running gourami.

Run the local server with `gourami run`

Expand All @@ -56,6 +78,7 @@ To create a user account:
* Run the sql command `insert into registration_keys values ("123")`
* Go to `http://localhost:3030/register?key=123`
* Create an account and log in
* Have fun!

## Deployment

Expand Down
6 changes: 3 additions & 3 deletions docs/ADMIN_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,13 @@ If you want to administer a Gourami server, you'll need a few technical skills:

## Deployment

Once you've built Gourami, you'll have a standalone binary that runs the server. Nothing else is needed, aside from Sqlite, OpenSSL and a TLS cert! I put together an ansible playbook that you may find helpful in `ansible/`. You'll need to modify the environment variables (an example is in sample_env) for your production deployment. If you are having trouble deploying Gourami, feel free to send me an email or open a GitHub issue. I plan on writing more detailed instructions for deploying a production server at some point.
Once you've built Gourami, you'll have a standalone binary that runs the server. Nothing else is needed, aside from Sqlite and a TLS cert! If you'd like, you can also set up an Nginx proxy. I put together an ansible playbook that you may find helpful in `ansible/`. You'll need to modify the environment variables (an example is in sample_env) for your production deployment. If you are having trouble deploying Gourami, feel free to send me an email or open a GitHub issue. I plan on writing more detailed instructions for deploying a production server at some point.

It should be relatively straightforward to deploy this on a Raspberry Pi too -- I plan on doing this at some point, and I'll put together a guide for it.
I do not use Docker for my Gourami deployment, so I have not created any Dockerfiles. Since the only dependency not inside the binary is Sqlite, I question the value of using a Docker container.

## Inviting users

Gourami is invite-only. Right now, you create an invite by adding a record to the invitation_keys table and sharing that key with the user you're inviting. You'll have to do this for yourself as well.
Gourami is invite-only. You can control who can invite users by setting the can_invite flag for that user in the user table.

## Connecting with other servers.

Expand Down

0 comments on commit a5e66f8

Please sign in to comment.