This is the Federation service for the Sublinks project. It's built using Go.
Together with the Sublinks Core and Sublinks Frontend it's creating a federated link aggregation and microblogging platform.
Please post any feature requests or bug reports in the repository's Issues section.
go install golang.org/x/vuln/cmd/govulncheck@latestgo install -v github.com/go-critic/go-critic/cmd/gocritic@latest- Install golangci-lint
- Install pre-commit
pre-commit install
To use this Docker setup you first need to complete a few steps:
- Authenticate towards GitHub's container registry(GHCR)
- Please follow this guide to create an access token and authenticate before running the below command.
- Run
git submodule update --init --recursiveto pull down all submodules - docker-compose -f docker/docker-compose.federation.yaml up [-d]
- -d to run in detached mode (don't include the [] brackets, they indicate being optional)
- Copy .env-sample to .env
- Replace values in .env file
- Run
go run ./cmd/ - Open localhost:8080
NOTE: Sublinks is still in early development. This text is added for future use and should not be taken as an indication that Sublinks is ready for use in a real production environment
A docker image is generated as an artifact of this repository and it is the preferred way of running the service. Environment variables should be passed to the image using standard Docker workflows (using a docker-compose.yaml is the preferred solution)