Skip to content

Deployment and Maintenance / Raspberry Pi Official System Deployment

This document mainly introduces how to run this system on a Raspberry Pi that has installed the official Raspberry Pi OS system.

Always use the latest version of DataFlux Func for operations

It is recommended to use a wired network connection to the Raspberry Pi during operation

This guide is based on the Raspberry Pi 4B 8GB version. The Raspberry Pi 3B is too weak to run the system.

1. Preparations

Before installing DataFlux Func on the Raspberry Pi, some preparations are required.

1.1 Burn the SD Card

It is recommended to burn a clean official image onto the SD card before installing DataFlux Func.

During the SD card burning process, you can choose:

  1. Use the official Raspberry Pi Imager tool for burning

  2. Directly download the official Raspberry Pi OS image and use a third-party tool for burning

After burning is complete, insert the SD card into the Raspberry Pi and power it on to start.

1.2 Enable ARM 64-bit Mode

For backward compatibility, the official Raspberry Pi OS does not enable 64-bit mode by default. However, all models starting from the Raspberry Pi 3B support enabling 64-bit mode.

You can use the following command to open the Raspberry Pi configuration:

Bash
1
sudo vi /boot/config.txt

Add the following content to enable ARM 64-bit mode:

Text Only
1
arm_64bit=1

Save and restart the Raspberry Pi.

After restarting, you can confirm with the following command:

Bash
1
arch

The output will be as follows:

Text Only
1
aarch64

2. Install DataFlux Func

Installing DataFlux Func on the Raspberry Pi is basically the same as installing it on a regular server.

2.1 Download

Downloading is the same as on other platforms; just use the following command. The script will detect the current environment architecture and download ARM version resources.

Bash
1
/bin/bash -c "$(curl -fsSL docs.dataflux-func.com/download)"

If you need to download the DataFlux Func installation package suitable for the Raspberry Pi on a PC, you need to specify --aarch64 in the download command

Bash
1
/bin/bash -c "$(curl -fsSL docs.dataflux-func.com/download)" -- --arch=aarch64

2.2 Installation

After downloading, enter the downloaded directory and execute the following command to install:

Bash
1
sudo /bin/bash run-portable.sh

2.3 Initialize the System

After installation, access the DataFlux Func initialization page via a browser to proceed with setup.

  • On the Raspberry Pi itself, visit http://127.0.0.1:8088
  • From another device accessing the Raspberry Pi, visit http://{Raspberry Pi IP}:8088

2.4 Confirm Installation

After installation, log in to the system, go to 「Manage / About」, and you will see that the "Architecture" is aarch64:

management-about-aarch64.png

From here on, the operation is no different from installing DataFlux Func on a regular server.

3. Configure WI-FI Connection

If you want the Raspberry Pi to connect to the network using WI-FI after installing DataFlux Func, please read this section.

After installing DataFlux Func, the WI-FI control panel on the Raspberry Pi taskbar may display No wireless interfaces found, and WI-FI cannot be connected via UI methods. At the same time, wired connections can access the network normally.

This issue has been observed during testing but the exact cause remains unclear; however, it does not affect wired connections.

3.1 Fixing Raspberry Pi WI-FI Issues

To fix this issue, open the network configuration:

Bash
1
sudo vi /etc/network/interfaces

Add the following configuration:

Bash
1
2
3
4
5
auto wlan0
allow-hotplug wlan0
iface wlan0 inet dhcp
wpa-ssid {Your WI-FI SSID}
wpa-psk {Your WI-FI Password}

Save and restart the Raspberry Pi.

3.2 Confirm Issue Fix

Use the following command to check the WI-FI module:

Bash
1
iwconfig wlan0

The output will be:

Text Only
1
2
3
4
5
6
7
8
wlan0     IEEE 802.11  ESSID:"{Your WI-FI SSID}"
          Mode:Managed  Frequency:2.472 GHz  Access Point: 08:36:C9:FC:3B:B0
          Bit Rate=72.2 Mb/s   Tx-Power=31 dBm
          Retry short limit:7   RTS thr:off   Fragment thr:off
          Power Management:on
          Link Quality=70/70  Signal level=-35 dBm
          Rx invalid nwid:0  Rx invalid crypt:0  Rx invalid frag:0
          Tx excessive retries:254  Invalid misc:0   Missed beacon:0

Use the following command to confirm WI-FI network connectivity:

Bash
1
ifconfig wlan0

The output will be:

Text Only
1
2
3
4
5
6
7
8
wlan0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet {IP address assigned to Raspberry Pi}  netmask 255.255.255.0  broadcast 10.0.0.255
        inet6 fe80::e65f:1ff:fe30:c85d  prefixlen 64  scopeid 0x20<link>
        ether e4:5f:01:30:c8:5d  txqueuelen 1000  (Ethernet)
        RX packets 33397  bytes 5759317 (5.4 MiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 28599  bytes 22218944 (21.1 MiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

Finally, open a browser and ensure you can browse the web normally, indicating that the WI-FI issue has been resolved.

Alternatively, you can directly use cURL to verify if internet connectivity is successful:

Bash
1
curl -L bing.com

Even if the WI-FI issue has been resolved, the WI-FI control panel in the taskbar may still display No wireless interfaces found

X. Appendix

This section records some contents related to the Raspberry Pi for reference.

X.1 Maximizing Raspberry Pi Performance

Open the /boot/config.txt file:

Bash
1
sudo vim /boot/firmware/usercfg.txt

Add the following content as needed:

Text Only
1
2
3
4
5
force_turbo=0  # Prevent CPU from running at maximum frequency
arm_freq=2100  # Overclock CPU to 2.1GHz (default is 1.5GHz)
gpu_freq=750   # Overclock GPU to 750MHz
gpu_mem=512    # Change video memory to 512MB
over_voltage=6 # Increase voltage to level 6

The system works fine even without these settings, and passive cooling with just a metal case is sufficient.

These settings involve overclocking. Passive cooling alone with just a metal case is insufficient when running under full load; at least one fan is required.

More aggressive configurations can further enhance Raspberry Pi performance but will void the warranty.

If your Raspberry Pi is damaged due to overclocking, the author of this article assumes no responsibility—please think carefully before proceeding.

X.2 Raspberry Pi Stress Testing Program

You can use the Raspberry Pi stress testing tool to test the stability of the Raspberry Pi's operation (especially after overclocking).

Clone the project repository:

Bash
1
git clone https://gitee.com/sujivin/rpi-cpu-stress.git

The original GitHub repository address is: github.com/xukejing/rpi-cpu-stress

Add executable permissions:

Bash
1
2
cd rpi-cpu-stress
chmod +x stress.sh

Start the stress test:

Bash
1
sudo ./stress.sh

In the terminal, you will see output like the following:

Text Only
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
a72 freq: 2100000
temp: 50634

a72 freq: 2100000
temp: 54530

a72 freq: 2100000
temp: 55991

a72 freq: 2100000
temp: 56478
  • a72 freq: 2100000: Indicates the current CPU frequency is 2.1GHz.
  • temp: 50634: Indicates the temperature is 50.634 degrees Celsius.

Do not allow the Raspberry Pi to remain at high temperatures (above 80 degrees Celsius) for extended periods.

X.3 Installing Chinese Input Method on Raspberry Pi

Execute the following commands in the terminal to install the 'Zhongzhou Rime' input method:

Bash
1
sudo apt-get install fcitx fcitx-rime

After installation, add the 'Zhongzhou Rime' input method via 「Preferences -> Fcitx Configuration -> Add Input Method」.

X.4 Installing Chinese Fonts on Raspberry Pi

Execute the following commands in the terminal to install the 'WenQuanYi' font:

Bash
1
2
sudo apt-get install ttf-wqy-zenhei
sudo fc-cache