Everything you need

to know.

What is SharkDeck?

SharkDeck™ Gen 1 is a compact Linux cyberdeck built around the WalnutPi Zero 2W platform. It gives you a real terminal-first Linux environment in a handheld form factor, with a built-in display, compact keyboard, battery-powered UPS system, USB-C power, Ethernet, Wi-Fi, Bluetooth, and GPIO expansion.

Use it for:

• Learning Linux commands
• SSH server management
• Writing and testing scripts
• Running Python and Node.js tools
• Checking system status
• Prototyping simple GPIO projects
• Using terminal-based AI coding tools
• Working from a small portable Linux terminal

Before You Start

Before powering on SharkDeck, make sure you have the required accessories and understand how the system works.

Requirements:

• microSD card is required
• USB-C power source
• Wi-Fi network or Ethernet connection
• Basic Linux terminal knowledge recommended
• Keyboard and screen are built into the device
• External modules are optional and are not included unless clearly listed in your order

First Boot

1. Insert the prepared microSD card.
2. Connect USB-C power.
3. Power on the device.
4. Wait for Linux to boot.
5. Log in using the default credentials provided in your order guide.
6. Connect to Wi-Fi or Ethernet.
7. Update packages before installing extra tools.

sudo apt update\nsudo apt upgrade -y

Note: Boot time may vary depending on the microSD card speed and installed software.

Power & Charging

SharkDeck includes an integrated UPS power board with rechargeable lithium battery support. This allows the device to run as a portable Linux terminal and helps provide safer power delivery during use.

Power notes:

• Use a stable USB-C power source.
• Battery life depends on screen brightness, CPU usage, Wi-Fi, connected USB devices, and GPIO usage.
• Do not disconnect power during system updates.
• Shut down the Linux system properly before removing power.

Safe shutdown command:

sudo shutdown now

microSD Storage

SharkDeck uses a microSD card for the Linux operating system and storage. The microSD card is required for booting and saving files.

Recommended:

• Use a reliable branded microSD card
• Minimum 16GB recommended
• 32GB or higher recommended for development tools
• Faster cards improve boot and package installation speed

SSH Access

SharkDeck can be used as a portable SSH terminal for managing remote servers, checking logs, editing files, restarting services, and running terminal commands.

Example SSH command:

ssh user@server-ip

Example with SSH key:

ssh -i ~/.ssh/id_rsa user@server-ip

Use cases:

• Server checks
• Deployment fixes
• Log monitoring
• Remote file editing
• Git pull / push workflows

Safety note: Only connect to servers and systems you own or have permission to access.

Software & Terminal Tools

SharkDeck supports common Linux terminal tools and development packages.

Supported tools may include:

• Python
• Node.js
• npm
• Git
• SSH
• Docker
• Terminal editors
• System monitoring tools
• VS Code Server

Example install commands:

sudo apt update\nsudo apt install git python3 python3-pip nodejs npm openssh-client -y

python3 --version

git --version

Node.js check:

node -v\nnpm -v

Docker note: Docker support depends on the installed Linux image, available storage, and system configuration.

AI Coding Tools

SharkDeck does not include a built-in AI assistant by default. However, users can install and use terminal-based AI coding tools if supported by their Linux setup.

Example use cases:

• Ask for code help in terminal
• Generate scripts
• Debug Linux commands
• Write Python utilities
• Create GPIO test scripts
• Document projects

GPIO Expansion for Makers

SharkDeck includes GPIO expansion for simple hardware prototyping and Linux learning projects. Users can connect compatible sensors, LEDs, buttons, small modules, and UART devices depending on their setup.

Use cases:

• LED control
• Button input
• Sensor testing
• UART serial communication
• Small maker projects
• Linux GPIO learning

Example safe Python GPIO concept:

import time

print("GPIO test script placeholder")
print("Connect supported hardware only and check pinout before use")

System Status Display

SharkDeck can display useful system information for monitoring the device.

Possible status info:

Example terminal commands:

htop\nfree -h\ndf -h\nuptime

Temperature command example:

cat /sys/class/thermal/thermal_zone0/temp

Technical Specifications

What SharkDeck Is Not

What's Included

Frequently Asked Questions

Important Notes

SharkDeck is a beta / early hardware build. Small differences may exist between batches. Software, preinstalled tools, and documentation may be updated over time.

• Shipping timeline may vary by batch.
• Some features depend on the installed Linux image.
• microSD speed affects performance.
• External modules require user setup.
• Use only legal and authorized workflows.
• Documentation will be improved with future updates.