RaspiLedOkWeb Setup Guide

A web application for controlling LED displays on Raspberry Pi and other ARM64 Linux systems.

Prerequisites

• Linux ARM64 system (Raspberry Pi 4, Pi 5, or compatible ARM64 device)
• Root or sudo access
• Internet connection for initial setup

Quick Installation

Step 1: Download and Extract

1. Download the linux-arm64 binary to your system
2. Create the application directory and move the binary:

sudo mv linux-arm64 /home/snyder/Desktop
dos2unix setup-service.sh
sudo ln -s /home/snyder/.dotnet/dotnet /usr/bin/dotnet

Step 2: Service Setup

1. Navigate to the application directory:

cd /home/snyder/Desktop

2. Important: Make sure you have the setup-service.sh file in this directory. If it's missing, you need to download it from your project repository or create it with the service configuration.

3. Check if the setup script exists:

ls -la setup-service.sh

4. Make the setup script executable:

chmod +x setup-service.sh

5. Run the setup script:

./setup-service.sh

If you get "command not found", try:

bash setup-service.sh

The service will be automatically installed and started.

Manual Configuration

If you need to customize the application settings, edit the configuration variables in setup-service.sh before running it:

nano setup-service.sh

Configuration Variables

Edit these values in the setup script according to your needs:

# Configuration - EDIT THESE VALUES
APP_NAME="RaspiLedOkWeb"
APP_PATH="/home/RaspiLedOkWeb"
APP_EXECUTABLE="RaspiLedOkWeb"
SERVICE_PORT="5000"
ENVIRONMENT="Production"

Variable	Description	Default Value
APP_NAME	Name of the application and service	RaspiLedOkWeb
APP_PATH	Full path to application directory	/home/RaspiLedOkWeb
APP_EXECUTABLE	Name of the executable file	RaspiLedOkWeb
SERVICE_PORT	Port the web application will run on	5000
ENVIRONMENT	Application environment mode	Production

Custom Installation Path

If you want to install to a different location, update both the file placement and the configuration:

1. Create your custom directory:

sudo mkdir -p /your/custom/path

2. Move the binary:

sudo mv linux-arm64 /your/custom/path/RaspiLedOkWeb
sudo chmod +x /your/custom/path/RaspiLedOkWeb

3. Update setup-service.sh:

APP_PATH="/your/custom/path"

Service Management

After installation, you can manage the service using systemctl:

Check service status:

sudo systemctl status RaspiLedOkWeb

Start the service:

sudo systemctl start RaspiLedOkWeb

Stop the service:

sudo systemctl stop RaspiLedOkWeb

Restart the service:

sudo systemctl restart RaspiLedOkWeb

Enable auto-start on boot:

sudo systemctl enable RaspiLedOkWeb

View service logs:

sudo journalctl -u RaspiLedOkWeb -f

Accessing the Application

Once the service is running, you can access the web interface at:

http://your-raspberry-pi-ip:5000

Or on the local machine:

http://localhost:5000

Troubleshooting

Permission Issues

If you encounter permission errors:

sudo chown -R $USER:$USER /home/RaspiLedOkWeb
sudo chmod +x /home/RaspiLedOkWeb/RaspiLedOkWeb

Port Already in Use

If port 5000 is already in use:

1. Edit setup-service.sh and change SERVICE_PORT to an available port
2. Re-run the setup script

Service Won't Start

Check the service logs for detailed error information:

sudo journalctl -u RaspiLedOkWeb --no-pager

Firewall Issues

If you can't access the web interface from other devices, check your firewall:

sudo ufw allow 5000

File Structure

After installation, your directory structure should look like:

/home/RaspiLedOkWeb/
├── RaspiLedOkWeb          # Main executable
├── setup-service.sh       # Service setup script
└── [other application files]

Uninstallation

To remove the application and service:

1. Stop and disable the service:

sudo systemctl stop RaspiLedOkWeb
sudo systemctl disable RaspiLedOkWeb

2. Remove the service file:

sudo rm /etc/systemd/system/RaspiLedOkWeb.service
sudo systemctl daemon-reload

3. Remove application files:

sudo rm -rf /home/RaspiLedOkWeb

Support

For issues or questions:

• Check the application logs using journalctl
• Verify all file permissions are correct
• Ensure the ARM64 binary is compatible with your system
• Check that the specified port is available and not blocked by firewall

---

Note: Make sure your system supports ARM64 binaries and has all necessary dependencies installed before running the application.