Skip to content

anadskman/SurfNAS

Repository files navigation

SurfNAS

A simple NAS ran by a raspberry pi

How To Run

To Use this youll have to run a few commands in terminal first and download Raspberry Pi OS

Install Libraries

Install Raspberry Pi OS Open Terminal and Run

sudo apt update
sudo apt install python3-pip git

Then Install Libraries

pip3 install adafruit-circuitpython-neopixel
pip3 install adafruit-circuitpython-ssd1306
pip3 install psutil
pip3 install pillow

This will Control

  • OLED
  • RGB LED
  • system stats

Enable I2C for the OLED

Run

sudo raspi-config

Then

Interface Options
→ I2C
→ Enable

Run the Firmware

Make sure youve install Nano SurfNAS.py

python3 surfnas.py

This Should Happen

  • OLED showing stats
  • LED changing color
  • button shuts down system

Start It Automatically

Create a systemd service

sudo nano /etc/systemd/system/surfnas.service

Paste

[Unit]
Description=SurfNAS Display Service
After=multi-user.target

[Service]
ExecStart=/usr/bin/python3 /home/pi/surfnas.py
Restart=always
User=pi

[Install]
WantedBy=multi-user.target

Enable It

sudo systemctl enable surfnas
sudo systemctl start surfnas

What SurfNAS Should Show

OLED screen:

  • SurfNAS
  • CPU: 23%
  • RAM: 41%
  • Disk: 18%

LED:

Color Meaning
Green normal
Orange moderate load
Red heavy load

Button:

  • Power Control

BOM

Name Description URL QTY Price(€)
Raspberry Pi Zero 2 WH To Run the Server Amazon 1 24.55
MicroSD Card 32GB Aliexpress 1 6.66
SSD 128GB USB 3.0 Amazon 1 20.99
OLED 0.96 I2C Aliexpress 1 2.63
Fan 30mm Cooling Fan Amazon 1 5.78
Button Red Push Button 2 Pin Aliexpress 1 1.61
RGB LED SK6812MINI-E Owned - Reuse From Hackpad Kit 1 0.00
Heat Sink Blue kit Aliexpress 1 2.36
USB Adapter C to Micro Amazon 1 3.66
Shipping 4.89
Total 73.13

Images

Schematic Case Finished Look
Image Image Image

About

A simple NAS ran by a raspberry pi

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages