---
schema_version: "1"
id: 55f21f8cb1d7c69a0d53b897b2ed38c91a761509cb863e7388b7bb3452dd2dca
title: Troubleshooting Linux Permissions
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/gateway/1.9/flex-troubleshoot-linux-permissions.md
canonical_url: https://docs.mulesoft.com/gateway/1.9/flex-troubleshoot-linux-permissions
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 00036108e76a294cb79709ac5af6a54f813b94d4dcca9fac4c0e3d4c53ad0f7d
description: MuleSoft Documentation Site
release: "1.9"
latest: false
---
---
product: Omni Gateway
version: 1.9
---

# Troubleshooting Linux Permissions

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

To help limit access to information about a Flex Gateway, the following `flexctl` commands can be
executed on Linux deployments only by the root user and by users in the `flex` user group:

- `flexctl dump`

- `flexctl version`

- `flexctl check connections`

- `flexctl probe`

- `flexctl registration inspect` (when executed without the `--file` flag)

There are two options to execute these commands:

- [Add the User to the Flex User Group](#add-user-to-flex-group)

- [Run as the Root User](#run-as-root-user)

## Add the User to the Flex User Group

Adding a user to the `flex` user group is a permanent solution and requires no action after the user
is added. Execute the following command to add the current user to the `flex` user group:

```ssh
sudo usermod -a -G flex $USER
```

After running the command, the user must log in to the VM again to begin using the `flexctl`
commands.

## Run as the Root User

Executing the `sudo` command with your `flexctl` command is the quickest way to access Flex Gateway
information. However, you must execute the `sudo` command every time you run a `flexctl` command if
the user is not part of the `flex` user group:

```ssh
sudo flexctl <command>
```

When the `sudo flexctl dump` command is executed, the root user is the owner of the created dump
files. If the current user is not the root user, the user cannot view the dumped files. To view the
files, execute the following command to change the owner of the files:

```ssh
sudo chown $USER *.json
```

## See Also

- [Troubleshooting with the CLI](https://docs.mulesoft.com/gateway/1.9/flex-troubleshoot-admin-api)

- [Known Issues](https://help.salesforce.com/s/issues)