mirrors/maddy
1
0
Fork 0
mirror of https://github.com/foxcpp/maddy.git synced 2025-04-04 05:37:34 +03:00
Code Issues Projects Releases Packages Wiki Activity
maddy/docs/tutorials/building-from-source.md
fox.cpp 28bdf6d33f
Make it easier to avoid permission issues when setting up maddy 
1. Clarify that you need to manually create the user and group
when building from source. ./build.sh does not do that since
it is a packaging tool, not system configuration one.

2. Do not require "go" command to be present when running
./build.sh install. go installation may be user-specific and
unavailable when running with sudo.

3. Ease UMask restrictions. Allow group access.
This allows CLI commands to be run by any user in maddy group.

See #569.
2024-01-21 21:57:00 +03:00

1.2 KiB
Raw Blame History

Building from source

System dependencies

You need C toolchain, Go toolchain and Make:

On Debian-based system this should work:

apt-get install golang-1.19 gcc libc6-dev make

Additionally, if you want manual pages, you should also have scdoc installed. Figuring out the appropriate way to get scdoc is left as an exercise for reader (for Ubuntu 22.04 LTS it is in repositories).

Recent Go toolchain

maddy depends on a rather recent Go toolchain version that may not be available in some distributions (cough Debian cough).

It should not be hard to grab a recent built toolchain from golang.org:

wget "https://dl.google.com/go/go1.19.9.linux-amd64.tar.gz"
tar xf "go1.19.19.linux-amd64.tar.gz"
export GOROOT="$PWD/go"
export PATH="$PWD/go/bin:$PATH"

Step-by-step

  1. Clone repository
$ git clone https://github.com/foxcpp/maddy.git
$ cd maddy
  1. Select the appropriate version to build:
$ git checkout v0.7.0      # a specific release
$ git checkout master      # next bugfix release
$ git checkout dev         # next feature release
  1. Build & install it
$ ./build.sh
$ sudo ./build.sh install
  1. Finish setup as described in Setting up (starting from System configuration).