<p align="center">
<a href="https://sentry.io/?utm_source=github&utm_medium=logo" target="_blank">
<picture>
<source srcset="https://sentry-brand.storage.googleapis.com/sentry-logo-white.png" media="(prefers-color-scheme: dark)" />
<source srcset="https://sentry-brand.storage.googleapis.com/sentry-logo-black.png" media="(prefers-color-scheme: light), (prefers-color-scheme: no-preference)" />
<img src="https://sentry-brand.storage.googleapis.com/sentry-logo-black.png" alt="Sentry" width="280">
</picture>
</a>
</p>
# Official Sentry Command Line Interface
[](https://github.com/getsentry/sentry-cli/actions?query=workflow%3ACI)
[](https://github.com/getsentry/sentry-cli/releases/latest)
[](https://www.npmjs.com/package/@sentry/cli)
[](https://github.com/getsentry/sentry-cli/blob/master/LICENSE)
This is a Sentry command line client for some generic tasks. Right now this is
primarily used to upload debug symbols to Sentry if you are not using the
Fastlane tools.
* Downloads can be found under
[Releases](https://github.com/getsentry/sentry-cli/releases/)
* Documentation can be found [here](https://docs.sentry.io/hosted/learn/cli/)
## Installation
If you are on OS X or Linux, you can use the automated downloader which will fetch the latest release version for you and install it:
curl -sL https://sentry.io/get-cli/ | bash
We do, however, encourage you to pin the specific version of the CLI, so your builds are always reproducible.
To do that, you can use the exact same method, with an additional version specifier:
curl -sL https://sentry.io/get-cli/ | SENTRY_CLI_VERSION=2.33.1 bash
This will automatically download the correct version of `sentry-cli` for your operating system and install it. If necessary, it will prompt for your admin password for `sudo`. For a different installation location or for systems without `sudo` (like Windows), you can `export INSTALL_DIR=/custom/installation/path` before running this command.
If you are using `sentry-cli` on Windows environments, [Microsoft Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist) is required.
To verify it’s installed correctly you can bring up the help:
sentry-cli --help
### pip
_New in 2.14.3_: `sentry-cli` can also be installed using `pip`:
```bash
pip install sentry-cli
```
### Node
Additionally, you can also install this binary via npm:
npm install @sentry/cli
When installing globally, make sure to have set
[correct permissions on the global node_modules directory](https://docs.npmjs.com/getting-started/fixing-npm-permissions).
If this is not possible in your environment or still produces an EACCESS error,
install as root:
sudo npm install -g @sentry/cli --unsafe-perm
By default, this package will download sentry-cli from the CDN managed by [Fastly](https://www.fastly.com/).
To use a custom CDN, set the npm config property `sentrycli_cdnurl`. The downloader will append
`"/<version>/sentry-cli-<dist>"`.
```sh
npm install @sentry/cli --sentrycli_cdnurl=https://mymirror.local/path
```
Or add property into your `.npmrc` file (https://www.npmjs.org/doc/files/npmrc.html)
```rc
sentrycli_cdnurl=https://mymirror.local/path
```
There are a few environment variables that you can provide to control the npm installation:
```
SENTRYCLI_CDNURL=<url> # Use alternative cdn url for downloading binary
SENTRYCLI_USE_LOCAL=1 # Use local instance of sentry-cli binary (looked up via $PATH environment)
SENTRYCLI_SKIP_DOWNLOAD=1 # Skip downloading binary entirely
SENTRYCLI_NO_PROGRESS_BAR=1 # Do not print the progress bar when downloading binary (default for non-TTY environments like CI)
SENTRYCLI_LOG_STREAM=<stdout|stderr> # Changes where to redirect install script output
```
When using `sentry-cli` via JavaScript API or any 3rd party plugin that is consuming said API,
you can also use `SENTRY_BINARY_PATH=<path>` alongside `SENTRYCLI_SKIP_DOWNLOAD=1` to completely
control what binaries are downloaded and used throughout the whole process.
If you're installing the CLI with NPM from behind a proxy, the install script will
use either NPM's configured HTTPS proxy server or the value from your `HTTPS_PROXY`
environment variable.
### Homebrew
A homebrew recipe is provided in the `getsentry/tools` tap:
brew install getsentry/tools/sentry-cli
### Docker
As of version _1.25.0_, there is an official Docker image that comes with
`sentry-cli` preinstalled. If you prefer a specific version, specify it as tag.
The latest development version is published under the `edge` tag. In production,
we recommend you to use the `latest` tag. To use it, run:
```sh
docker pull getsentry/sentry-cli
docker run --rm -v $(pwd):/work getsentry/sentry-cli --help
```
Starting version _`2.8.0`_, in case you see `"error: config value 'safe.directory' was not found;"` message,
you also need to correctly set UID and GID of mounted volumes like so:
```sh
docker run --rm -u "$(id -u):$(id -g)" -v $(pwd):/work getsentry/sentry-cli --help
```
This is required due to security issue in older `git` implementations. See [here](https://github.blog/2022-04-12-git-security-vulnerability-announced/) for more details.
## Update
To update sentry-cli to the latest version run:
```sh
sentry-cli update
```
## Compiling
In case you want to compile this yourself, you need to install at minimum the
following dependencies:
* Rust stable and Cargo
* Make, CMake and a C compiler
Use cargo to compile:
$ cargo build
Also, there is a Dockerfile that builds an Alpine-based Docker image with
`sentry-cli` in the PATH. To build and use it, run:
```sh
docker build -t sentry-cli .
docker run --rm -v $(pwd):/work sentry-cli --help
```
Raw data
{
"_id": null,
"home_page": "https://github.com/getsentry/sentry-cli",
"name": "sentry-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": null,
"author": "Sentry",
"author_email": "oss@sentry.io",
"download_url": "https://files.pythonhosted.org/packages/53/0c/e301d943f2c591f088d32a4ee819adf1d86f889dcdf989c928d441bbbf36/sentry_cli-2.38.2.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <a href=\"https://sentry.io/?utm_source=github&utm_medium=logo\" target=\"_blank\">\n <picture>\n <source srcset=\"https://sentry-brand.storage.googleapis.com/sentry-logo-white.png\" media=\"(prefers-color-scheme: dark)\" />\n <source srcset=\"https://sentry-brand.storage.googleapis.com/sentry-logo-black.png\" media=\"(prefers-color-scheme: light), (prefers-color-scheme: no-preference)\" />\n <img src=\"https://sentry-brand.storage.googleapis.com/sentry-logo-black.png\" alt=\"Sentry\" width=\"280\">\n </picture>\n </a>\n</p>\n\n# Official Sentry Command Line Interface\n\n[](https://github.com/getsentry/sentry-cli/actions?query=workflow%3ACI)\n[](https://github.com/getsentry/sentry-cli/releases/latest)\n[](https://www.npmjs.com/package/@sentry/cli)\n[](https://github.com/getsentry/sentry-cli/blob/master/LICENSE)\n\nThis is a Sentry command line client for some generic tasks. Right now this is\nprimarily used to upload debug symbols to Sentry if you are not using the\nFastlane tools.\n\n* Downloads can be found under\n [Releases](https://github.com/getsentry/sentry-cli/releases/)\n* Documentation can be found [here](https://docs.sentry.io/hosted/learn/cli/)\n\n## Installation\n\nIf you are on OS X or Linux, you can use the automated downloader which will fetch the latest release version for you and install it:\n\n curl -sL https://sentry.io/get-cli/ | bash\n\nWe do, however, encourage you to pin the specific version of the CLI, so your builds are always reproducible.\nTo do that, you can use the exact same method, with an additional version specifier:\n\n curl -sL https://sentry.io/get-cli/ | SENTRY_CLI_VERSION=2.33.1 bash\n\nThis will automatically download the correct version of `sentry-cli` for your operating system and install it. If necessary, it will prompt for your admin password for `sudo`. For a different installation location or for systems without `sudo` (like Windows), you can `export INSTALL_DIR=/custom/installation/path` before running this command.\n\nIf you are using `sentry-cli` on Windows environments, [Microsoft Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist) is required.\n\nTo verify it\u2019s installed correctly you can bring up the help:\n\n sentry-cli --help\n\n### pip\n\n_New in 2.14.3_: `sentry-cli` can also be installed using `pip`:\n\n```bash\npip install sentry-cli\n```\n\n### Node\n\nAdditionally, you can also install this binary via npm:\n\n npm install @sentry/cli\n\nWhen installing globally, make sure to have set\n[correct permissions on the global node_modules directory](https://docs.npmjs.com/getting-started/fixing-npm-permissions).\nIf this is not possible in your environment or still produces an EACCESS error,\ninstall as root:\n\n sudo npm install -g @sentry/cli --unsafe-perm\n\nBy default, this package will download sentry-cli from the CDN managed by [Fastly](https://www.fastly.com/).\nTo use a custom CDN, set the npm config property `sentrycli_cdnurl`. The downloader will append\n`\"/<version>/sentry-cli-<dist>\"`.\n\n```sh\nnpm install @sentry/cli --sentrycli_cdnurl=https://mymirror.local/path\n```\n\nOr add property into your `.npmrc` file (https://www.npmjs.org/doc/files/npmrc.html)\n\n```rc\nsentrycli_cdnurl=https://mymirror.local/path\n```\n\nThere are a few environment variables that you can provide to control the npm installation:\n\n```\nSENTRYCLI_CDNURL=<url> # Use alternative cdn url for downloading binary\nSENTRYCLI_USE_LOCAL=1 # Use local instance of sentry-cli binary (looked up via $PATH environment)\nSENTRYCLI_SKIP_DOWNLOAD=1 # Skip downloading binary entirely\nSENTRYCLI_NO_PROGRESS_BAR=1 # Do not print the progress bar when downloading binary (default for non-TTY environments like CI)\nSENTRYCLI_LOG_STREAM=<stdout|stderr> # Changes where to redirect install script output\n```\n\nWhen using `sentry-cli` via JavaScript API or any 3rd party plugin that is consuming said API,\nyou can also use `SENTRY_BINARY_PATH=<path>` alongside `SENTRYCLI_SKIP_DOWNLOAD=1` to completely\ncontrol what binaries are downloaded and used throughout the whole process.\n\nIf you're installing the CLI with NPM from behind a proxy, the install script will\nuse either NPM's configured HTTPS proxy server or the value from your `HTTPS_PROXY`\nenvironment variable.\n\n### Homebrew\n\nA homebrew recipe is provided in the `getsentry/tools` tap:\n\n brew install getsentry/tools/sentry-cli\n\n### Docker\n\nAs of version _1.25.0_, there is an official Docker image that comes with\n`sentry-cli` preinstalled. If you prefer a specific version, specify it as tag.\nThe latest development version is published under the `edge` tag. In production,\nwe recommend you to use the `latest` tag. To use it, run:\n\n```sh\ndocker pull getsentry/sentry-cli\ndocker run --rm -v $(pwd):/work getsentry/sentry-cli --help\n```\n\nStarting version _`2.8.0`_, in case you see `\"error: config value 'safe.directory' was not found;\"` message,\nyou also need to correctly set UID and GID of mounted volumes like so:\n\n```sh\ndocker run --rm -u \"$(id -u):$(id -g)\" -v $(pwd):/work getsentry/sentry-cli --help\n```\n\nThis is required due to security issue in older `git` implementations. See [here](https://github.blog/2022-04-12-git-security-vulnerability-announced/) for more details.\n\n## Update\n\nTo update sentry-cli to the latest version run:\n\n```sh\nsentry-cli update\n```\n\n## Compiling\n\nIn case you want to compile this yourself, you need to install at minimum the\nfollowing dependencies:\n\n* Rust stable and Cargo\n* Make, CMake and a C compiler\n\nUse cargo to compile:\n\n $ cargo build\n\nAlso, there is a Dockerfile that builds an Alpine-based Docker image with\n`sentry-cli` in the PATH. To build and use it, run:\n\n```sh\ndocker build -t sentry-cli .\ndocker run --rm -v $(pwd):/work sentry-cli --help\n```\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "A command line utility to work with Sentry.",
"version": "2.38.2",
"project_urls": {
"Homepage": "https://github.com/getsentry/sentry-cli"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b1c35df65d0cfa1b2622bb68799a5d409633a259c2c0cf68d3455f2491127fb8",
"md5": "b353011da3d07385770711f1379c78a4",
"sha256": "54130b95617b5473458ad266e0d98619302dd039a9191a360555265e3d9d3e67"
},
"downloads": -1,
"filename": "sentry_cli-2.38.2-py3-none-macosx_10_15_x86_64.whl",
"has_sig": false,
"md5_digest": "b353011da3d07385770711f1379c78a4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 8906574,
"upload_time": "2024-11-04T12:35:52",
"upload_time_iso_8601": "2024-11-04T12:35:52.916247Z",
"url": "https://files.pythonhosted.org/packages/b1/c3/5df65d0cfa1b2622bb68799a5d409633a259c2c0cf68d3455f2491127fb8/sentry_cli-2.38.2-py3-none-macosx_10_15_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "357d366158586d175538f49e968f0cc47d1f7376bc3f40f6d5309f8410638492",
"md5": "2546b6c4cc818f1acfae061b1f77f1ae",
"sha256": "1a774f47c0af11ffade918d0334f477b3b212f128e8c1a02b19b85a8d15ca5f4"
},
"downloads": -1,
"filename": "sentry_cli-2.38.2-py3-none-macosx_11_0_arm64.whl",
"has_sig": false,
"md5_digest": "2546b6c4cc818f1acfae061b1f77f1ae",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 7884060,
"upload_time": "2024-11-04T12:35:55",
"upload_time_iso_8601": "2024-11-04T12:35:55.186026Z",
"url": "https://files.pythonhosted.org/packages/35/7d/366158586d175538f49e968f0cc47d1f7376bc3f40f6d5309f8410638492/sentry_cli-2.38.2-py3-none-macosx_11_0_arm64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4ae518eaf32fddf43143011e02f2426d01dd148ba76882c947a9f31e2895a4bb",
"md5": "cc44c9029172ea5f6d97a8c20b1a8e99",
"sha256": "4ed2d16b6621b7d6800989faf900be1c86609621dec4a26b8758e7b59ed2a661"
},
"downloads": -1,
"filename": "sentry_cli-2.38.2-py3-none-macosx_11_0_universal2.whl",
"has_sig": false,
"md5_digest": "cc44c9029172ea5f6d97a8c20b1a8e99",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 16796962,
"upload_time": "2024-11-04T12:35:56",
"upload_time_iso_8601": "2024-11-04T12:35:56.992451Z",
"url": "https://files.pythonhosted.org/packages/4a/e5/18eaf32fddf43143011e02f2426d01dd148ba76882c947a9f31e2895a4bb/sentry_cli-2.38.2-py3-none-macosx_11_0_universal2.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c9d4647daa748b9a77ca80a0fb5e2c874abb57b5988c7df02bac013b3e72d88d",
"md5": "da10bfec3fc77dbb29fa0374460540e0",
"sha256": "88e5f96ef4cdd2c45ef054c78656d93727f1b5e4e27b9c14eef2c792f9780526"
},
"downloads": -1,
"filename": "sentry_cli-2.38.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_2_aarch64.whl",
"has_sig": false,
"md5_digest": "da10bfec3fc77dbb29fa0374460540e0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 11440226,
"upload_time": "2024-11-04T12:35:59",
"upload_time_iso_8601": "2024-11-04T12:35:59.054019Z",
"url": "https://files.pythonhosted.org/packages/c9/d4/647daa748b9a77ca80a0fb5e2c874abb57b5988c7df02bac013b3e72d88d/sentry_cli-2.38.2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_2_aarch64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b8c1ff3418a84b3ecc4b50f712d2bd29e62e2f3012f249d112ae481a6663ddd2",
"md5": "4c1503b9f87f80d037297bddde4c8b51",
"sha256": "af31f5bfd3b9abc3b29237674048614e54d812a36ac59ec56c54ae3311867269"
},
"downloads": -1,
"filename": "sentry_cli-2.38.2-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.musllinux_1_2_armv7l.whl",
"has_sig": false,
"md5_digest": "4c1503b9f87f80d037297bddde4c8b51",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 10566275,
"upload_time": "2024-11-04T12:36:01",
"upload_time_iso_8601": "2024-11-04T12:36:01.657832Z",
"url": "https://files.pythonhosted.org/packages/b8/c1/ff3418a84b3ecc4b50f712d2bd29e62e2f3012f249d112ae481a6663ddd2/sentry_cli-2.38.2-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.musllinux_1_2_armv7l.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6aa911db68e3b4fcb3d741d26da2fb525339f56abb7057296ae705098862c063",
"md5": "2cc822a0e6d90556f957ce4393a022d0",
"sha256": "1f5b5ce3add7f37fefd74598e75204e7cbd3d1e34c812089154f87c7b7606d77"
},
"downloads": -1,
"filename": "sentry_cli-2.38.2-py3-none-manylinux_2_17_i686.manylinux2014_i686.musllinux_1_2_i686.whl",
"has_sig": false,
"md5_digest": "2cc822a0e6d90556f957ce4393a022d0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 12119425,
"upload_time": "2024-11-04T12:36:04",
"upload_time_iso_8601": "2024-11-04T12:36:04.063407Z",
"url": "https://files.pythonhosted.org/packages/6a/a9/11db68e3b4fcb3d741d26da2fb525339f56abb7057296ae705098862c063/sentry_cli-2.38.2-py3-none-manylinux_2_17_i686.manylinux2014_i686.musllinux_1_2_i686.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "15a47bc66dd136a07af31cb8b732875a5837ab6ffde40f6d6abb6e7a23d59a62",
"md5": "e4a62ba1512216040cb0c58e3eb6373a",
"sha256": "e7add04b357b9041a14fd4e38419837bdd1117785fa61b2b3d9786ba18f73082"
},
"downloads": -1,
"filename": "sentry_cli-2.38.2-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_2_x86_64.whl",
"has_sig": false,
"md5_digest": "e4a62ba1512216040cb0c58e3eb6373a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 14470687,
"upload_time": "2024-11-04T12:36:06",
"upload_time_iso_8601": "2024-11-04T12:36:06.771408Z",
"url": "https://files.pythonhosted.org/packages/15/a4/7bc66dd136a07af31cb8b732875a5837ab6ffde40f6d6abb6e7a23d59a62/sentry_cli-2.38.2-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_2_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "84635726e314a63d127c8ab7ffc05e9fcbe33ba831efe87122be9529143cb4ef",
"md5": "308a5b8d44eb776b9c94ebf508c93850",
"sha256": "e531df0b825b4e0036452e619c45c2ee976ea699f77ac0760bda4ab3e74f10e1"
},
"downloads": -1,
"filename": "sentry_cli-2.38.2-py3-none-win32.whl",
"has_sig": false,
"md5_digest": "308a5b8d44eb776b9c94ebf508c93850",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 7524868,
"upload_time": "2024-11-04T12:36:11",
"upload_time_iso_8601": "2024-11-04T12:36:11.915644Z",
"url": "https://files.pythonhosted.org/packages/84/63/5726e314a63d127c8ab7ffc05e9fcbe33ba831efe87122be9529143cb4ef/sentry_cli-2.38.2-py3-none-win32.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d1feafda5581d64c633124cdb584ecb781d24a3f2eceb3dadc8fc42cfec30fe1",
"md5": "a5b57acef7c0005d543d45acfff3615a",
"sha256": "c929d622407c93f91b042a87c1763fe30d8bf7b1bd53e896fcb43f2c9ea8a556"
},
"downloads": -1,
"filename": "sentry_cli-2.38.2-py3-none-win_amd64.whl",
"has_sig": false,
"md5_digest": "a5b57acef7c0005d543d45acfff3615a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 8789000,
"upload_time": "2024-11-04T12:36:14",
"upload_time_iso_8601": "2024-11-04T12:36:14.582328Z",
"url": "https://files.pythonhosted.org/packages/d1/fe/afda5581d64c633124cdb584ecb781d24a3f2eceb3dadc8fc42cfec30fe1/sentry_cli-2.38.2-py3-none-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "530ce301d943f2c591f088d32a4ee819adf1d86f889dcdf989c928d441bbbf36",
"md5": "ed46b264d68c3db66ba725949e924f43",
"sha256": "a18dbdf7558a373f4730f11d5aab4a28d27823eb6d5e58edceb70860d1572621"
},
"downloads": -1,
"filename": "sentry_cli-2.38.2.tar.gz",
"has_sig": false,
"md5_digest": "ed46b264d68c3db66ba725949e924f43",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 199474,
"upload_time": "2024-11-04T12:36:16",
"upload_time_iso_8601": "2024-11-04T12:36:16.594512Z",
"url": "https://files.pythonhosted.org/packages/53/0c/e301d943f2c591f088d32a4ee819adf1d86f889dcdf989c928d441bbbf36/sentry_cli-2.38.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-04 12:36:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "getsentry",
"github_project": "sentry-cli",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "sentry-cli"
}
JSON
