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

# 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
```

Files in the `conf.d` directory must have `644` permissions, allowing the owner to read and write,
and the group and others to read.

## See Also

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

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