Support Guidelines

When using Parrot Support, please observe the following guidelines:

  1. Read and search Parrot’s Documentation before you post. Also Check out our FAQ.
    (Also look at Debian’s documentation and the documentation of the application or tool you are using)

  2. At the bare minimum we expect you did the following:

  • You searched on the internet using a search engine of your choice.
  • You have searched the man pages available on your issue.

(If you don’t what we’re talking about see Troubleshooting tl;dr use (ALT+T) to pull up Mate Terminal and execute:


Where TOPIC is the item you’d like to learn about. If not found, check our troubleshooting page.)

  • Finally search the forum before you post, failure to do these things will get your post locked and/or deleted. No, we’re not out to get you, the internet is a very large space and with almost 8 billion humans on the planet someone has likely asked and answered or ran into your problem. Wasting our time because of your laziness is stupid.
  1. Do not cross post or double post. Posting the same topic in more than one category only creates confusion and makes it hard to keep track on the various replies. Double posts will be deleted.

  2. Be descriptive, check here for examples. Use a meaningful headline and try to make your question as clear as possible. Include as much information as possible such as what tool, OS version (Home versus Security) you are using, error messages, what you did that may have caused the problem etc. at minimum include the following:

   # Please complete our guideline for issue report or idea suggestion
## If you are having an issue, please follow this
**There are many kinds of issues: OS, software, server, ... So you must know:**
- Server issues will be fixed after report and we verify the problem. There will be no update patch for you. It is server side.
- 3rd party software / packages can't be fixed by us. If we can spot the bug and have the fix, we will create merge request to original source and wait for their official version.
- Life is hard. For bug/ issue, please make sure your topic is only one. Dont make developers be terrorists.
- This is a rolling distro. Bugs and issues are expected. We recommend you have basic linux knowledge to deal with your system, so
**Usually we don't support issues that user faces by using his system in a wrong way. If you are new to Linux, make sure you didn't make any mistake:**
1. Basic Linux:
2. How to not break Debian system: or
3. If you are having some questions, your answers might be in here:
4. Your issue might be solved before (StackOverflow is a temple), try this:
### 1. Your Parrot information
 - OS version: run `cat /etc/*release`
        Copy output here
- Kernel version: run `uname -a`
        Copy output here

*Or if you can't do it, please tell us ISO version you downloaded.*

** ISO information **

Version: 4.9
Desktop Environment: Mate
Edition: Home

### 2. If you have this problem after fresh installation:
1. How did you create USB bootable?

    - Software was used to make USB
    - Steps of making USB bootable

2. How did you install OS?
    - Debian installer or Calamares installer?

### 3. If your hardware doesn't work: wifi doesn't show, graphic issue:

**Hardware information**

    - Your device name or output of `lspci`
        Copy output here
    - Did you try searching info about this issue on search engine? Please write **No** or any URL to this issue bellow

### 4. How did you get this error? Are there any steps to procedure it?
    1. I installed this
    2. I ran this new software
    3. It shows me this or that

### 5. Error log or screenshot
** Insert error log and screenshot here**

### 6. If you have any idea or suggestion about this issue please tell us
** Your information **

## If you are having suggestion for our OS, please write it bellow
### 1. Current Parrot version and Parrot version you want it has

### 2. Its section and how it affects our system

- Pentesting / Forensic / Malware hunting / Privacy protection / ...
- It is: AppArmor profile / software / system service / kernel module...
- when user runs this / start that, it can do....

### 3. Any other information about this idea
  1. Failure to have this information when needed will get your post unlisted, you will be send a PM, with what you need add or fix. Failure to amend your post will get it deleted after 72 hours (3 days).

  2. When posting code or logs use the grave accent symbol (it’s the key above Tab) to mark the beginning and end if pasting it directly e.g.

echo "Hello World"
``` (end of code)

Using pastebin is also welcome. Photos are a last resort. Please use them only if you are unable to copy the code. If you do use photos do not link them from an outside resource use the upload button and link them through the web link provided.

  1. Be patient. Not everyone knows everything and not everyone is online all the time. If you don’t get a reply chances are that no one is online that knows the answer at the moment. Do not ‘bump’ your questions just because there have been a few hours with no reply. If your question is specific to the developers, a moderator will assign a developer to respond. Again, please be patient.

  2. Do not post spam or reply to spam, if you think it’s spam flag the post with the flag icon or notify a moderator. If you think the post is inappropriate or violates our TOS please flag it as well and a moderator will check it out.

  3. Be polite. The skill level of the forum members ranges total beginner to the very crusty Linux user and what might be obvious to you might be very hard to understand for others. Its perfectly acceptable to tell people to RTFM but, don’t be a dick. There is a difference between not knowing something and being just plain lazy.

  4. Foster a learning environment. Guiding people to a solution is more more important than doling out answers like a minigun. Yeah, you might have the perfect solution but that person will never learn. It enables help vampires which waste the communities collective energy.

  5. Avoid ‘thread hijacking’. Unless your issue is identical to the OP’s thread topic, start a new one. If your issue is identical but you have different hardware or edition start a new topic.

  6. The language on this board is primarily English but we do not exclude people with little or no English. When replying to posts in other languages please include an English translation. It’s a good idea to help non-English speakers find resources in their language.

  7. A forum is a means of written communication so make sure your posts are as readable as possible. That means: Use capital letters and punctuation, and use the formatting features of the forum wisely in order to make your post attractive.

  8. There is no need to apologize for poor English skills. We have users from all over the world and trying your best is more than adequate.

  9. Stay on topic and keep it relevant to Parrot OS. Long off-topic discussions in other categories will get moved, locked or de-listed and eventually deleted. Moderators might move your thread to a more suitable category (for instance from ‘Support to Support Setup and Configuration’). This is no cause for alarm we are simply trying to keep things tidy.

  10. the following topics have been covered in our documentation portal so please:

    • Don’t ask about third party repositories. The instructions to fix your mistake is on our docs portal.
    • Don’t ask about root logins, Parrot OS isn’t designed that way. Use Kali if it’s a must have item.
  11. The following will get your post/topic removed and your account banned:

    • Advertising
    • Racist/ sexist content
    • Political/ religious content
    • Obvious pornographic content
    • Personal attacks (attack the flaw in their argument, not the person)

    The following might get your post/topic locked/de-listed

    • Flaming/
    • Obvious trolling
    • Thread has wandered way off topic
    • Cross posting
    • Questions that have been answered in our docs FAQ (Reading is an important and valuable skill)
  12. If you feel like your post/ thread has been locked, edited or even removed in error, please contact a moderator.

  13. If you have an issue with a moderator do not fight with them please contact them and attempt to resolve the issue or contact @Reporting with details of why you think the actions taken were wrong.

We are happy to help guide you in the right direction. Please understand though, we are a group of friends who’ve volunteered to do this. No one gets paid to be here.

-The Parrot Team