alihan/exatorrent-seedbox-server-cli
1
0
Fork 0
mirror of https://github.com/varbhat/exatorrent.git synced 2021-09-19 22:57:02 +03:00
Code Issues Projects Releases Wiki Activity
Files
4727f22ed89e7776c338843e229ad5a33b2aa48d
exatorrent-seedbox-server-cli/docs/build.md
Var Bhat 4727f22ed8 first commit
2021-08-26 02:23:47 +05:30

3.0 KiB
Raw Blame History

Build Docs

This Documents how to build exatorrent from sources .

exatorrent is written in Go . As such you need go to be installed in order to compile .

exatorrent is dependent on sqlite3 ( used as database ) and libutp ( used for uTP connections ) . As such , you also require C and C++ compilers to be installed in order to compile . gcc is preferred but clang also compiles well . There is no need to install any devel packages or sqlite or headers in system to compile exatorrent , as Source comes bundeled with drivers crawshaw/sqlite and libutp and C compiler is used to compile cgo code .

exatorrent comes with beautiful , small and performant Web Client . It is written in Svelte + TypeScript . It gets bundled with amazing esbuild and the built web client is then embedded within the binary using Go's embed . Node.js is thus required to build Web Client . Note that Node.js is required only to build Web Client written in Svelte and not required thereafter (i.e exatorrent is not dependent on Node.js and Node.js in only required to build Web Client ).

For sake of Convenience although not necessary to build exatorrent , Build commands of exatorrent are written in Makefile . Install make to execute make commands . Note that you can also manually type build commands instead of using make .

Requirements

Requirements to build Web Client :

  • Node.js (node and npm must be available )

Build

Since Web Client will be embedded within final binary , Web Client needs to be built first .

Web Client can be built by :

make web

After building web client , exatorrent can be built by :

make app

You can see built exatorrent in build directory .

If you don't have make installed , you can execute these commands manually to build exatorrent :

cd internal/web && npm install && npm run build
cd ../..
env CGO_ENABLED=1 go build -trimpath -buildmode=pie -ldflags '-extldflags "-static -s -w"' -o  build/exatorrent exatorrent.go

Notes

  • See Building Docker/Podman Images if you want to build exatorrent Docker / Podman Images .
  • If you don't want to build Web Client or want to skip building Web Client , you can do it by creating empty / dummy index.html file at internal/web/build directory ( Create build folder if it didn't exist ) . Note that Web Client will not be available then .