DOCS
TRAFEXIADOCSGetting Started

Getting Started with Trafexia

Welcome to Trafexia, the professional mobile HTTPS traffic interceptor, API analyzer, and reverse engineering desktop suite.

This guide covers step-by-step instructions to install Trafexia and trust the local Root CA certificate across macOS, Windows, and Linux.


Operating System Installation Guides

🍏 1. macOS Installation & Trust Setup

  1. Download: Obtain the latest .dmg package from the Releases page.
  2. Install: Open the .dmg file and drag Trafexia.app into your Applications folder.
  3. Launch Proxy: Open Trafexia and click Start Proxy (runs on http://127.0.0.1:8888).
  4. Install Root CA Certificate:
    • In Trafexia, click Export CA Certificate (saves trafexia-ca.crt).
    • Double-click trafexia-ca.crt to open Keychain Access.
    • Select System (or login) keychain -> Certificates.
    • Double-click Trafexia Root CA, expand Trust, and change When using this certificate to Always Trust.
    • Enter your macOS admin password to confirm.

🪟 2. Windows Installation & Trust Setup

  1. Download: Obtain the latest .exe installer from the Releases page.
  2. Install: Run Trafexia-Setup-x64.exe and complete the installation wizard.
  3. Launch Proxy: Open Trafexia and click Start Proxy. Allow Windows Firewall access for Port 8888 if prompted.
  4. Install Root CA Certificate:
    • Click Export CA Certificate inside Trafexia.
    • Double-click trafexia-ca.crt -> Click Install Certificate....
    • Select Local Machine -> Click Next.
    • Choose Place all certificates in the following store -> Click Browse.
    • Select Trusted Root Certification Authorities -> Click OK and Finish.

🐧 3. Linux Installation & Trust Setup (Ubuntu / Debian / Arch)

  1. Download: Obtain the .AppImage bundle from the Releases page.
  2. Make Executable:
    chmod +x Trafexia-x86_64.AppImage
    ./Trafexia-x86_64.AppImage
    
  3. Install Root CA Certificate System-wide:
    • Export trafexia-ca.crt from the Trafexia app.
    • Copy the certificate into your system CA trust folder:
      # Ubuntu / Debian / Mint:
      sudo cp trafexia-ca.crt /usr/local/share/ca-certificates/trafexia-ca.crt
      sudo update-ca-certificates
      
      # Arch Linux / Manjaro:
      sudo cp trafexia-ca.crt /etc/ca-certificates/trust-source/anchors/
      sudo trust extract-compat
      

Next Steps

Now that Trafexia is running and your desktop machine trusts the Root CA, proceed to configure your mobile devices: