Skip to content

Getting Started with railbird

This document describes how to get started with the railbird repository.

Install Nix

Follow the instructions at nix at railbird docs for installing nix.

Set up git and gitea

Follow the instructions about gettting set up with git.

Initialize the nix flake development environment

With direnv

Make sure that you have given our .envrc permission with direnv allow

With nix develop

Android

nix develop --impure

Install python dependencies

Run the just install command to install all python depdencies

just install

Issues with C module build in macOS

In some cases, the build of C modules (usually dependency-injector) can cause issues with the bundled clang when running just install.

On hacky way to fix this is to figure out where your clang binary normally is outside of direnv/nix develop (typically /usr/bin) and manually add that path to your PATH environment variable before running just install:

export PATH="/usr/bin:$PATH"
just install