rooter is a local environment manager that helps orchestrating local developer environments for multiple projects.

It brings a traefik instance that manages routing to the projects.
Alongside that is has a lot of commands to solve day-to-day repetitive tasks.

This guide assumes you have successfully installed:

• nix package manager https://nixos.org/download.html#nix-install-macos
  • enable flakes https://nixos.wiki/wiki/Flakes
    add the following to ~/.config/nix/nix.conf or /etc/nix/nix.conf

    experimental-features = nix-command flakes

• devenv https://devenv.sh/getting-started/
• direnv & nix-direnv
  • direnv https://direnv.net/docs/installation.html
    • you can use HomeBrew: brew install direnv
    • or nix profile: nix profile install "nixpkgs#direnv"
    • make sure to hook it into your shell: https://direnv.net/docs/hook.html
  • nix-direnv https://github.com/nix-community/nix-direnv#with-nix-profile

What exactly is being installed on macOS is documented here: https://nixos.org/manual/nix/stable/installation/installing-binary.html#macos-installation.

nix profile install --accept-flake-config "github:run-as-root/rooter?ref=main#rooter"

rooter needs to place some configurations, initialise directories, ssl certs, etc.
To start the installation run:

./rooter install

After that rooter is setup and ready to use for your projects.

List of commands without explanation.

rooter env:create <environment-type>
direnv allow .
rooter start --debug # once done cancel with CTRL+C
rooter start

To create a new enviroment for a project run

rooter env:create <environment-type>

This will copy the environment specific files to your current project and create them with default values.
You can provide a custom project name by adding the option --name=<my-custom-name>.

rooter env:create magento2 --name="my-first-rooter-env"

Manually add .devenv/ and .env to .gitignore

This command will also create a .env file in your project root or overwrite values for rooter.
It will find available ports for the project and write them to the .env file.
Ports will be selected from a range defined for each service type.

With direnv it is possible to automatically initialise the environment when you enter the project directory.
To activate this feature, run the following command in your project directory.

direnv allow .

When this is activated the first time, dependencies for the CLI will be fetched, installed and configured for this project.

Once you have completed the above steps you can start the environment for the first time.

For the first run we suggest to start it in the foreground since this might take a while to fetch all dependencies.

rooter start --debug

For all subsequent starts you can run it in the background with

rooter start

rooter --help
rooter --help <command>

rooter can be configured via environment variables.
To find out more about the available options and how to use them, please refer to the configuration options.

To find out more about the available commands and how to use them, please refer to the commands.

• TEMPLATES
• KNOWN ISSUES
• DEVELOPMENT & CONTRIBUTION