docs/building-linux.md

   1 ## Build instructions for Linux using Docker
   2
   3 ### Prepare folder
   4
   5 Choose a folder for the future build, for example **/home/user/TBuild**. It will be named ***BuildPath*** in the rest of this document. All commands will be launched from Terminal.
   6
   7 ### Obtain your API credentials
   8
   9 You will require **api_id** and **api_hash** to access the Telegram API servers. To learn how to obtain them [click here][api_credentials].
  10
  11 ### Clone source code and prepare libraries
  12
  13 Install [poetry](https://python-poetry.org), go to ***BuildPath*** and run
  14
  15     git clone --recursive https://github.com/telegramdesktop/tdesktop.git
  16     ./tdesktop/Telegram/build/prepare/linux.sh
  17
  18 ### Building the project
  19
  20 Go to ***BuildPath*/tdesktop** and run (using [your **api_id** and **api_hash**](#obtain-your-api-credentials))
  21
  22     docker run --rm -it \
  23         -v "$PWD:/usr/src/tdesktop" \
  24         tdesktop:centos_env \
  25         /usr/src/tdesktop/Telegram/build/docker/centos_env/build.sh \
  26         -D TDESKTOP_API_ID=YOUR_API_ID \
  27         -D TDESKTOP_API_HASH=YOUR_API_HASH
  28
  29 Or, to create a debug build, run (also using [your **api_id** and **api_hash**](#obtain-your-api-credentials))
  30
  31     docker run --rm -it \
  32         -v "$PWD:/usr/src/tdesktop" \
  33         -e CONFIG=Debug \
  34         tdesktop:centos_env \
  35         /usr/src/tdesktop/Telegram/build/docker/centos_env/build.sh \
  36         -D TDESKTOP_API_ID=YOUR_API_ID \
  37         -D TDESKTOP_API_HASH=YOUR_API_HASH
  38
  39 The built files will be in the `out` directory.
  40
  41 [api_credentials]: api_credentials.md