--- title: "Getting Started" slug: "application-fshark2-getting-started" updated: 2024-12-17T05:01:16Z published: 2024-12-17T05:01:16Z canonical: "docs.fmad.io/application-fshark2-getting-started" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.fmad.io/llms.txt > Use this file to discover all available pages before exploring further. # Getting Started FMADIO Shark v2 is a full Ubuntu 22 Linux Container (LXC) enabling the full Wireshark GUI and RDP desktop enviroment all running on the FMADIO Hardware Platform. ## Step 1) Download the LXC Download the latest version of fshark from the web [https://static.fmad.io/container.html](https://static.fmad.io/container.html)[#fshark2](https://firmware.fmad.io/container.html#fshark2) This can be done using CURL in the following directory ```plaintext cd /opt/fmadio/lxc ``` Then Downloading using the CURL command (assuming the FMADIO System has internet access). Alternatively the tarball can be copied from a remote system into the same directory. --- ## Step 2) Extract the tarball Extract the tarball as sudo ```plaintext sudo tar xfzv fshark2-20241021-1204.tar.gz ``` Example output below: ```plaintext fmadio@fmadio200v4-636:/opt/fmadio/lxc$ sudo tar xfzv fshark2-20241021-1204.tar.gz fshark2-20241021-1204/ fshark2-20241021-1204/fmadiocli-start.lua fshark2-20241021-1204/install.lua fshark2-20241021-1204/fmadiocli-del.lua fshark2-20241021-1204/config fshark2-20241021-1204/backup.lua fshark2-20241021-1204/fmadiocli-stop.lua fshark2-20241021-1204/rootfs/ fshark2-20241021-1204/rootfs/sys/ fshark2-20241021-1204/rootfs/proc/ fshark2-20241021-1204/rootfs/home/ fshark2-20241021-1204/rootfs/home/fmadio/ fshark2-20241021-1204/rootfs/home/fmadio/.bash_logout fshark2-20241021-1204/rootfs/home/fmadio/.vimrc fshark2-20241021-1204/rootfs/home/fmadio/.bashrc fshark2-20241021-1204/rootfs/home/fmadio/.config/ fshark2-20241021-1204/rootfs/home/fmadio/.config/wireshark/ fshark2-20241021-1204/rootfs/home/fmadio/.config/wireshark/profiles/ fshark2-20241021-1204/rootfs/home/fmadio/.config/tint2/ fshark2-20241021-1204/rootfs/home/fmadio/.config/tint2/tint2rc fshark2-20241021-1204/rootfs/home/fmadio/.config/openbox/ fshark2-20241021-1204/rootfs/home/fmadio/.config/openbox/autostart fshark2-20241021-1204/rootfs/home/fmadio/.Xauthority fshark2-20241021-1204/rootfs/home/fmadio/fmadio-background.png fshark2-20241021-1204/rootfs/home/fmadio/wireshark-lua/ fshark2-20241021-1204/rootfs/home/fmadio/wireshark-lua/Cboe/ fshark2-20241021-1204/rootfs/home/fmadio/wireshark-lua/Cboe/Cboe_Futures_OrderEntry_Boe3_v1_0_Dissector.lua fshark2-20241021-1204/rootfs/home/fmadio/wireshark-lua/Cboe/Cboe_Pitch_SequencedUnitHeader_Pitch_v1_0_Dissector.lua fshark2-20241021-1204/rootfs/home/fmadio/wireshark-lua/Cboe/Cboe_Edgx_Equities_DepthOfBook_Pitch_v2_41_29_Dissector.lua fshark2-20241021-1204/rootfs/home/fmadio/wireshark-lua/Cboe/ReadMe.md fshark2-20241021-1204/rootfs/home/fmadio/wireshark-lua/Cboe/Cboe_Options_Complex_Pitch_v2_1_37_Dissector.lua fshark2-20241021-1204/rootfs/home/fmadio/wireshark-lua/Cboe/Cboe_Options_DepthOfBook_Pitch_v2_39_4_Dissector.lua fshark2-20241021-1204/rootfs/home/fmadio/wireshark-lua/Cboe/Cboe_Options_MarketLevel2_Csm_v1_0_4_Dissector.lua . . . fshark2-20241021-1204/rootfs/opt/google/chrome/libqt6_shim.so fshark2-20241021-1204/rootfs/opt/google/chrome/MEIPreload/ fshark2-20241021-1204/rootfs/opt/google/chrome/MEIPreload/preloaded_data.pb fshark2-20241021-1204/rootfs/opt/google/chrome/MEIPreload/manifest.json fshark2-20241021-1204/rootfs/opt/google/chrome/product_logo_256.png fshark2-20241021-1204/rootfs/opt/google/chrome/vk_swiftshader_icd.json fshark2-20241021-1204/rootfs/opt/google/chrome/chrome_100_percent.pak fshark2-20241021-1204/rootfs/opt/google/chrome/xdg-settings fshark2-20241021-1204/rootfs/opt/google/chrome/google-chrome fshark2-20241021-1204/rootfs/opt/google/chrome/product_logo_32.png fshark2-20241021-1204/rootfs/opt/google/chrome/chrome fshark2-20241021-1204/rootfs/opt/google/chrome/default-app-block fshark2-20241021-1204/rootfs/opt/google/chrome/chrome_200_percent.pak fshark2-20241021-1204/rootfs/opt/google/chrome/chrome-sandbox fshark2-20241021-1204/rootfs/run/ fshark2-20241021-1204/rootfs/srv/ fshark2-20241021-1204/rootfs/sbin fshark2-20241021-1204/fmadiocli-add.lua fmadio@fmadio200v4-636:/opt/fmadio/lxc$ ``` --- ## Step 3) Install the LXC Installing the LXC will configure it for the system, all commands need to be run as root ```plaintext sudo su ``` Then cd to the extracted fshark2 directory ```plaintext fmadio@fmadio200v4-636:/opt/fmadio/lxc$ sudo su root@fmadio200v4-636:/mnt/store1/lxc/lib/lxc# cd fshark2-20241021-1204/ root@fmadio200v4-636:/mnt/store1/lxc/lib/lxc/fshark2-20241021-1204# ``` Then run the install script ```plaintext ./install.lua ``` Example output below: ```plaintext root@fmadio200v4-636:/mnt/store1/lxc/lib/lxc/fshark2-20241021-1204# ./install.lua fmad fmadlua Dec 16 2024 (/opt/fmadio/bin/fmadiolua --nocal ./install.lua ) Disable cycle calibration man0 imported man0 ipv4 addr    [nil] man0 ipv4 netmask [nil] man0 ipv4 gw      [nil] man0 ipv4 dns     [nil] lxcname           [nil] lxcbuild          [nil] nat            [y] fmad fmadlua Dec 16 2024 (/opt/fmadio/bin/fmadiolua --nocal /opt/fmadio/bin/fmadiocli version ) Disable cycle calibration done 0.003627Sec 0.000060Min ----------------------------------------------- [Tue Dec 17 12:15:53 2024] CmdLine [version] [Tue Dec 17 12:15:53 2024] Cmd [version ] ----------------------------------------------- fmadiocliPresent = true fshark2-20241021-1204 rm config mkdir /opt/fmadio/lxc/fshark2-20241021-1204/data/ -p mkdir /opt/fmadio/lxc/fshark2-20241021-1204/log/ -p ---------------------- IP     : nil CIDR   : nil GW     : nil DNS    : nil Nat    : y /opt/fmadio/bin/fmadiocli "config ring add lxc_fshark2" fmad fmadlua Dec 16 2024 (/opt/fmadio/bin/fmadiolua --nocal /opt/fmadio/bin/fmadiocli config ring add lxc_fshark2 ) Disable cycle calibration [Tue Dec 17 12:15:53 2024] CmdLine [config ring add lxc_fshark2] [Tue Dec 17 12:15:53 2024] Cmd [config ring add lxc_fshark2 ] [Tue Dec 17 12:15:53 2024] --------------------------------------------------------------------------------------------------------------------------------- [Tue Dec 17 12:15:53 2024] Created Ring named [lxc_fshark2] cycle calibration disabled null  output RING reset RING file [/opt/fmadio/queue/lxc_fshark2] RING[/opt/fmadio/queue/lxc_fshark2                     ] Size missmatch 0 12595200 RING[/opt/fmadio/queue/lxc_fshark2                     ] Size   : 12595200 16777216 RING[/opt/fmadio/queue/lxc_fshark2                     ] Version:        0      100 RING[/opt/fmadio/queue/lxc_fshark2                     ] version wrong force reset RING[/opt/fmadio/queue/lxc_fshark2                     ] Put:0 0 0x7f284e62f000 RING[/opt/fmadio/queue/lxc_fshark2                     ] Get:0 0 0x7f284e630000 [Tue Dec 17 12:15:54 2024] created ring [/opt/fmadio/queue/lxc_fshark2] done 0.721891Sec 0.012032Min rm /opt/fmadio/lxc/fshark2-20241021-1204/rootfs/etc/resolv.conf touch /opt/fmadio/lxc/fshark2-20241021-1204/rootfs/etc/resolv.conf echo fmadio200v4-636-fshark2 > /opt/fmadio/lxc/fshark2-20241021-1204/rootfs/etc/hostname echo 127.0.0.1 fmadio200v4-636-fshark2 >> /opt/fmadio/lxc/fshark2-20241021-1204/rootfs/etc/hosts /opt/fmadio/bin/fmadiocli "config lxc add fshark2-20241021-1204" fmad fmadlua Dec 16 2024 (/opt/fmadio/bin/fmadiolua --nocal /opt/fmadio/bin/fmadiocli config lxc add fshark2-20241021-1204 ) Disable cycle calibration [Tue Dec 17 12:15:54 2024] CmdLine [config lxc add fshark2-20241021-1204] [Tue Dec 17 12:15:54 2024] Cmd [config lxc add fshark2-20241021-1204 ] [Tue Dec 17 12:15:54 2024] Added container [fshark2-20241021-1204] to the configuration done 0.708595Sec 0.011810Min done done 1.451537Sec 0.024192Min root@fmadio200v4-636:/mnt/store1/lxc/lib/lxc/fshark2-20241021-1204# ``` --- ## Step 4) Start the LXC Using the `fmadiocli` start and attach to the LXC to confirm it runs correctly ```plaintext fmadiocli "config lxc start fshark2" ``` Example output: ```plaintext fmadio@fmadio200v4-636:/opt/fmadio/lxc$ fmadiocli "config lxc start fshark2" fmad fmadlua Dec 16 2024 (/opt/fmadio/bin/fmadiolua --nocal /opt/fmadio/bin/fmadiocli config lxc start fshark2 ) Disable cycle calibration [Tue Dec 17 12:17:11 2024] CmdLine [config lxc start fshark2] [Tue Dec 17 12:17:11 2024] Cmd [config lxc start fshark2 ] [Tue Dec 17 12:17:11 2024] search for lxc named (fshark2) [Tue Dec 17 12:17:11 2024]     [ 1] * fshark2-20241021-1204 [Tue Dec 17 12:17:11 2024] sudo lxc-start -n fshark2-20241021-1204 --logfile /tmp/lxc_fshark2-20241021-1204_1734409031479305984 [Tue Dec 17 12:17:35 2024] [Tue Dec 17 12:17:35 2024] use the following on a shell to attach to the conatiners console [Tue Dec 17 12:17:35 2024] sudo lxc-attach -n fshark2-20241021-1204 [Tue Dec 17 12:17:35 2024] done 23.737702Sec 0.395628Min fmadio@fmadio200v4-636:/opt/fmadio/lxc$ ``` --- ## Step 5) Attach to the LXC Next is attach to the LXC as follows. This confirms everything is running as expected ```plaintext fmadiocli "config lxc attach fshark2" ``` Example output: ```plaintext fmadio@fmadio200v4-636:/opt/fmadio/lxc$ fmadiocli "config lxc attach fshark2" fmad fmadlua Dec 16 2024 (/opt/fmadio/bin/fmadiolua --nocal /opt/fmadio/bin/fmadiocli config lxc attach fshark2 ) Disable cycle calibration [Tue Dec 17 12:19:10 2024] CmdLine [config lxc attach fshark2] [Tue Dec 17 12:19:10 2024] Cmd [config lxc attach fshark2 ] [Tue Dec 17 12:19:10 2024] search for lxc named (fshark2) [Tue Dec 17 12:19:10 2024]     [ 1] * fshark2-20241021-1204 [Tue Dec 17 12:19:10 2024] sudo lxc-attach -n fshark2-20241021-1204 root@fmadio200v4-636-fshark2:/# ``` NOTE: FMADIO Applications the prompt will be GREEN when inside a container. This helps identify on the shell if its running on the host or in an LXC. ![](https://cdn.document360.io/b9aab0c4-36d0-4616-9673-30b661455571/Images/Documentation/image(65).png?sv=2026-02-06&spr=https&st=2026-11-13T18%3A04%3A13Z&se=2026-11-13T19%3A04%3A13Z&sr=c&sp=r&sig=4RRefN3lem8AUjP60nzifTL83H%2FL0o%2B7fq9j0qFj%2FLE%3D) --- ## Step 6) Setup Port forwarding for RDP By default the LXC runs on its own internal network without any access to the physically connected network. A typical install will port forward a host port into the LXC RDP server. This allows an RDP client to connect to the FShark2 LXC using the FMADIO Hosts IP address. Its described in the link below [https://docs4.fmad.io/docs/fmadio-os-network-topology#lxc-port-forwarding](https://docs4.fmad.io/docs/fmadio-os-network-topology#lxc-port-forwarding) ![](https://cdn.document360.io/b9aab0c4-36d0-4616-9673-30b661455571/Images/Documentation/image(66).png?sv=2026-02-06&spr=https&st=2026-11-13T18%3A04%3A13Z&se=2026-11-13T19%3A04%3A13Z&sr=c&sp=r&sig=4RRefN3lem8AUjP60nzifTL83H%2FL0o%2B7fq9j0qFj%2FLE%3D) In this example we are forwarding port 3389 on the host (default RDP port) into the LXC FShark2 container on the same port. This effectively lets you RDP to the FMADIO Host using an RDP connection. Copy the file located in ```plaintext cp /opt/fmadio/etc_ro/iptables_portfwd.conf  /opt/fmadio/etc/iptables.conf ``` Then reload the iptables configuration ```plaintext sudo iptables-restore < /opt/fmadio/etc/iptables.conf ``` --- ## Step 7) Connect using an RDP Client Load up the RDP client and try connect to the instance ![](https://cdn.document360.io/b9aab0c4-36d0-4616-9673-30b661455571/Images/Documentation/image(67).png?sv=2026-02-06&spr=https&st=2026-11-13T18%3A04%3A13Z&se=2026-11-13T19%3A04%3A13Z&sr=c&sp=r&sig=4RRefN3lem8AUjP60nzifTL83H%2FL0o%2B7fq9j0qFj%2FLE%3D) Note that the size of the desktop is configured by the RDP client. In this case a 2K configuration is used ![](https://cdn.document360.io/b9aab0c4-36d0-4616-9673-30b661455571/Images/Documentation/image(68).png?sv=2026-02-06&spr=https&st=2026-11-13T18%3A04%3A13Z&se=2026-11-13T19%3A04%3A13Z&sr=c&sp=r&sig=4RRefN3lem8AUjP60nzifTL83H%2FL0o%2B7fq9j0qFj%2FLE%3D) If using the native Windows RDP client it will provide a warning, click YES ![](https://cdn.document360.io/b9aab0c4-36d0-4616-9673-30b661455571/Images/Documentation/image(69).png?sv=2026-02-06&spr=https&st=2026-11-13T18%3A04%3A13Z&se=2026-11-13T19%3A04%3A13Z&sr=c&sp=r&sig=4RRefN3lem8AUjP60nzifTL83H%2FL0o%2B7fq9j0qFj%2FLE%3D) Showing the default FMADIO login per below ![](https://cdn.document360.io/b9aab0c4-36d0-4616-9673-30b661455571/Images/Documentation/image(70).png?sv=2026-02-06&spr=https&st=2026-11-13T18%3A04%3A13Z&se=2026-11-13T19%3A04%3A13Z&sr=c&sp=r&sig=4RRefN3lem8AUjP60nzifTL83H%2FL0o%2B7fq9j0qFj%2FLE%3D) --- ## Step 8) Login to the desktop Login using the account fmadio and the default fmadio password By default wireshark will load per below ![](https://cdn.document360.io/b9aab0c4-36d0-4616-9673-30b661455571/Images/Documentation/image(71).png?sv=2026-02-06&spr=https&st=2026-11-13T18%3A04%3A13Z&se=2026-11-13T19%3A04%3A13Z&sr=c&sp=r&sig=4RRefN3lem8AUjP60nzifTL83H%2FL0o%2B7fq9j0qFj%2FLE%3D) Terminal can be opened using the right mouse button on the desktop NOTE: The first window may take 30sec to be created as the system initializes itself ![](https://cdn.document360.io/b9aab0c4-36d0-4616-9673-30b661455571/Images/Documentation/image(72).png?sv=2026-02-06&spr=https&st=2026-11-13T18%3A04%3A13Z&se=2026-11-13T19%3A04%3A13Z&sr=c&sp=r&sig=4RRefN3lem8AUjP60nzifTL83H%2FL0o%2B7fq9j0qFj%2FLE%3D) ![](https://cdn.document360.io/b9aab0c4-36d0-4616-9673-30b661455571/Images/Documentation/image(73).png?sv=2026-02-06&spr=https&st=2026-11-13T18%3A04%3A13Z&se=2026-11-13T19%3A04%3A13Z&sr=c&sp=r&sig=4RRefN3lem8AUjP60nzifTL83H%2FL0o%2B7fq9j0qFj%2FLE%3D) Browser can also be created ![](https://cdn.document360.io/b9aab0c4-36d0-4616-9673-30b661455571/Images/Documentation/image(74).png?sv=2026-02-06&spr=https&st=2026-11-13T18%3A04%3A13Z&se=2026-11-13T19%3A04%3A13Z&sr=c&sp=r&sig=4RRefN3lem8AUjP60nzifTL83H%2FL0o%2B7fq9j0qFj%2FLE%3D)