kotatogram-desktop/docs/building-linux.md

## Build instructions for Linux using Docker

### Obtain your API credentials

You will require **api_id** and **api_hash** to access the Telegram API servers. To learn how to obtain them [click here][api_credentials].

### Clone source code

    git clone --recursive https://github.com/kotatogram/kotatogram-desktop.git

### Prepare libraries

Go to the `kotatogram-desktop` directory and run

    docker build -t kotatogram-desktop:centos_env Telegram/build/docker/centos_env/

### Building the project

Make sure that you're still in the `kotatogram-desktop` directory and run (using [your **api_id** and **api_hash**](#obtain-your-api-credentials))

    docker run --rm -it \
        -v $PWD:/usr/src/tdesktop \
        kotatogram-desktop:centos_env \
        /usr/src/tdesktop/Telegram/build/docker/centos_env/build.sh \
        -D TDESKTOP_API_ID=YOUR_API_ID \
        -D TDESKTOP_API_HASH=YOUR_API_HASH \
        -D DESKTOP_APP_USE_PACKAGED=OFF \
        -D DESKTOP_APP_DISABLE_CRASH_REPORTS=ON

Or, to create a debug build, run (also using [your **api_id** and **api_hash**](#obtain-your-api-credentials))

    docker run --rm -it \
        -v $PWD:/usr/src/tdesktop \
        -e DEBUG=1 \
        kotatogram-desktop:centos_env \
        /usr/src/tdesktop/Telegram/build/docker/centos_env/build.sh \
        -D TDESKTOP_API_ID=YOUR_API_ID \
        -D TDESKTOP_API_HASH=YOUR_API_HASH \
        -D DESKTOP_APP_USE_PACKAGED=OFF \
        -D DESKTOP_APP_DISABLE_CRASH_REPORTS=ON

If you want to build with crash reporter, use `-D DESKTOP_APP_DISABLE_CRASH_REPORTS=OFF` instead of `-D DESKTOP_APP_DISABLE_CRASH_REPORTS=ON`.

The built files will be in the `out` directory.

[api_credentials]: api_credentials.md
Remove old instructions & patches they referred to (& rename instructions to the actual state) Old instruction names were from the time when tdesktop used GYP that had MSVC, XCode and CMake backends. But tdesktop uses CMake now, so these names are no longer correct. 2021-07-20 06:41:11 +04:00			`## Build instructions for Linux using Docker`
Moved all builds to GYP. 2016-09-12 14:45:41 +03:00
Don't provide 'api_id' and 'api_hash' by default. We ask the developer to obtain his own api credentials, because the bundled 'api_id' / 'api_hash' are strictly limited by the server. The old credentials still could be used for test purposes, but the developer will need to explicitly opt-in to use them. 2018-11-04 14:29:30 +04:00			`### Obtain your API credentials`

			`You will require api_id and api_hash to access the Telegram API servers. To learn how to obtain them [click here][api_credentials].`

Update Linux build instructions Co-authored-by: Ilya Fedin <fedin-ilja2010@ya.ru> 2020-12-13 01:16:37 -05:00			`### Clone source code`
Moved all builds to GYP. 2016-09-12 14:45:41 +03:00
Updated README and some docs 2021-01-04 08:48:01 +03:00			`git clone --recursive https://github.com/kotatogram/kotatogram-desktop.git`
Moved all builds to GYP. 2016-09-12 14:45:41 +03:00
Update Linux build instructions Co-authored-by: Ilya Fedin <fedin-ilja2010@ya.ru> 2020-12-13 01:16:37 -05:00			`### Prepare libraries`
Moved all builds to GYP. 2016-09-12 14:45:41 +03:00
Updated README and some docs 2021-01-04 08:48:01 +03:00			Go to the `kotatogram-desktop` directory and run
Moved all builds to GYP. 2016-09-12 14:45:41 +03:00
Updated README and some docs 2021-01-04 08:48:01 +03:00			`docker build -t kotatogram-desktop:centos_env Telegram/build/docker/centos_env/`
Moved all builds to GYP. 2016-09-12 14:45:41 +03:00
Move build to Ubuntu 14.04 and GCC 7.2. To be able to run on the same distributions as before we need to have the same GLIBC version dependency as in Ubuntu 12.04, which is 2.15. For that we need to remove all usages of GLIBC features from 2.16 and above. Currently there are three methods used, so they're wrapped in a separate static library, linux_glibc_wraps. It is a separate library because it must be compiled without '-flto' flag, otherwise the inline __asm__ is not working and we get unresolved symbols. 2017-09-28 12:40:26 +03:00			`### Building the project`
Moved all builds to GYP. 2016-09-12 14:45:41 +03:00
Updated README and some docs 2021-01-04 08:48:01 +03:00			Make sure that you're still in the `kotatogram-desktop` directory and run (using [your api_id and api_hash](#obtain-your-api-credentials))
Update Linux build instructions Co-authored-by: Ilya Fedin <fedin-ilja2010@ya.ru> 2020-12-13 01:16:37 -05:00
Run docker in interactive mode for colored output and Ctrl+C 2021-02-23 02:23:29 +04:00			`docker run --rm -it \`
Update Linux build instructions Co-authored-by: Ilya Fedin <fedin-ilja2010@ya.ru> 2020-12-13 01:16:37 -05:00			`-v $PWD:/usr/src/tdesktop \`
Updated README and some docs 2021-01-04 08:48:01 +03:00			`kotatogram-desktop:centos_env \`
Update Linux build instructions Co-authored-by: Ilya Fedin <fedin-ilja2010@ya.ru> 2020-12-13 01:16:37 -05:00			`/usr/src/tdesktop/Telegram/build/docker/centos_env/build.sh \`
			`-D TDESKTOP_API_ID=YOUR_API_ID \`
			`-D TDESKTOP_API_HASH=YOUR_API_HASH \`
			`-D DESKTOP_APP_USE_PACKAGED=OFF \`
Updated README and some docs 2021-01-04 08:48:01 +03:00			`-D DESKTOP_APP_DISABLE_CRASH_REPORTS=ON`
Update Linux build instructions Co-authored-by: Ilya Fedin <fedin-ilja2010@ya.ru> 2020-12-13 01:16:37 -05:00
			`Or, to create a debug build, run (also using [your api_id and api_hash](#obtain-your-api-credentials))`

Run docker in interactive mode for colored output and Ctrl+C 2021-02-23 02:23:29 +04:00			`docker run --rm -it \`
Update Linux build instructions Co-authored-by: Ilya Fedin <fedin-ilja2010@ya.ru> 2020-12-13 01:16:37 -05:00			`-v $PWD:/usr/src/tdesktop \`
			`-e DEBUG=1 \`
Updated README and some docs 2021-01-04 08:48:01 +03:00			`kotatogram-desktop:centos_env \`
Update Linux build instructions Co-authored-by: Ilya Fedin <fedin-ilja2010@ya.ru> 2020-12-13 01:16:37 -05:00			`/usr/src/tdesktop/Telegram/build/docker/centos_env/build.sh \`
			`-D TDESKTOP_API_ID=YOUR_API_ID \`
			`-D TDESKTOP_API_HASH=YOUR_API_HASH \`
			`-D DESKTOP_APP_USE_PACKAGED=OFF \`
Updated README and some docs 2021-01-04 08:48:01 +03:00			`-D DESKTOP_APP_DISABLE_CRASH_REPORTS=ON`

			If you want to build with crash reporter, use `-D DESKTOP_APP_DISABLE_CRASH_REPORTS=OFF` instead of `-D DESKTOP_APP_DISABLE_CRASH_REPORTS=ON`.
Update Linux build instructions Co-authored-by: Ilya Fedin <fedin-ilja2010@ya.ru> 2020-12-13 01:16:37 -05:00
			The built files will be in the `out` directory.
Moved all builds to GYP. 2016-09-12 14:45:41 +03:00
Don't provide 'api_id' and 'api_hash' by default. We ask the developer to obtain his own api credentials, because the bundled 'api_id' / 'api_hash' are strictly limited by the server. The old credentials still could be used for test purposes, but the developer will need to explicitly opt-in to use them. 2018-11-04 14:29:30 +04:00			`[api_credentials]: api_credentials.md`