Difference between revisions of "Installation"

Revision as of 14:10, 8 March 2026

Template:Note

Recommended: Pre-configured microSD Card Image (V1)

Step 1: Download and Flash the Image

Download the bcMeter image file here
Unzip the downloaded file
Use Etcher to flash the image to your microSD card:
- Insert your microSD card
- Open Etcher and select the image
- Select your microSD card as target
- Click "Flash!" and wait for completion

Step 2: Boot and Connect

Insert the flashed microSD card into the Raspberry Pi
Power on the device
Wait approximately 2 minutes for boot
Connect to the WiFi network "bcMeter" with password: bcMeterbcMeter

Step 3: Configure

Open a browser and navigate to http://bcmeter.local
The bcMeter interface will appear
Follow on-screen instructions

Advanced: Manual Setup via SSH (V1)

Use the Raspberry Pi Imager to write Raspberry OS 64-bit LITE to the microSD card. Do not install the Desktop variant.

Configure with username bcmeter and password bcmeter.org. Enable SSH and WiFi.

SSH Installation

ssh bcmeter@bcMeter
# or: ssh bcmeter@bcMeter.local

# Download and run installer
wget -N https://raw.githubusercontent.com/bcmeter/bcmeter/main/install.sh && sudo bash install.sh

This runs an unattended installation taking a few minutes.

Current Platform (ESP32)

The ESP32-based bcMeter comes with firmware pre-installed. Setup only requires:

Plug in power
Connect to the "bcMeter" WiFi hotspot
Open http://bcmeter.local
Follow the Welcome Screen

See Setup for detailed instructions.

@@ Line 1: / Line 1: @@
+{{Note|1='''Legacy V1 Documentation''' — This page documents Raspberry Pi software setup for the bcMeter V1. The current ESP32-based bcMeter comes pre-configured and is set up via the [[Setup#Welcome Screen|Welcome Screen]]. These instructions are preserved for V1 users.}}
+== Recommended: Pre-configured microSD Card Image (V1) ==
-== Recommended: Use of preconfigured microSD Card image ==
 === Step 1: Download and Flash the Image ===
 # Download the bcMeter image file [https://bcmeter.org/wp-content/uploads/simple-file-list/bcMeter_latest_img.zip here]
-# Unzip the downloaded file to extract the image
+# Unzip the downloaded file
 # Use [https://www.balena.io/etcher/ Etcher] to flash the image to your microSD card:
-#* Insert your microSD card into your computer
+#* Insert your microSD card
-#* Open Etcher and select the extracted image file
+#* Open Etcher and select the image
-#* Select your microSD card as the target
+#* Select your microSD card as target
-#* Click "Flash!" and wait for the process to complete
+#* Click "Flash!" and wait for completion
 === Step 2: Boot and Connect ===
-# Insert the flashed microSD card into your bcMeter device
+# Insert the flashed microSD card into the Raspberry Pi
 # Power on the device
-# Wait approximately 2 minutes for the device to boot completely
+# Wait approximately 2 minutes for boot
-# On your computer or mobile device, connect to the WiFi network named "'''bcMeter'''"
+# Connect to the WiFi network "'''bcMeter'''" with password: <code>bcMeterbcMeter</code>
-#* Use password: '''bcMeterbcMeter'''
-=== Step 3: Configure Your Device ===
-# Open a web browser
-# Navigate to [http://bcmeter.local bcmeter.local]
-# The bcMeter configuration interface will appear
-# Follow the on-screen instructions to complete your device setup
-=== Troubleshooting ===
-* If you cannot connect to the "bcMeter" WiFi network, try rebooting the device
-* If the web interface doesn't load, ensure you're connected to the correct WiFi network
-== Advanced: Manual headless Set Up the microSD Card ==
-Use the [https://www.raspberrypi.com/software/ Raspberry Imager] tool to write Raspberry OS 64bit LITE to the microSD-Card for Raspberry pi 3A+ (32bit LITE only for raspberry 2 - legacy - not suggested)
-Do '''not''' install the Dyesktop variant.
-Configure the Raspberry Pi Imager tool to configure the image with username and password, use "bcmeter" and "bcmeter.org" so the installer script.<br><br>
+=== Step 3: Configure ===
-Also enable SSH and WiFi in the tool.
-After finishing, eject the microSD Card from the PC and put it into the Raspberry Pi.
+# Open a browser and navigate to <code><nowiki>http://bcmeter.local</nowiki></code>
+# The bcMeter interface will appear
+# Follow on-screen instructions
+== Advanced: Manual Setup via SSH (V1) ==
-=== Configuring the Raspberry Pi to be a bcMeter via SSH remote access and WiFi ===
+Use the [https://www.raspberrypi.com/software/ Raspberry Pi Imager] to write '''Raspberry OS 64-bit LITE''' to the microSD card. Do '''not''' install the Desktop variant.
-Put microSD-Card in Raspberry and boot it up (takes up to a minute)
+Configure with username <code>bcmeter</code> and password <code>bcmeter.org</code>. Enable SSH and WiFi.
-Log into the raspberry via terminal on Linux/OSX or cmd.exe on Windows
+=== SSH Installation ===
-      ssh bcmeter@bcMeter
-or alternatively if connection is refused
-      ssh bcmeter@bcMeter.local
-Or to use with dedicated ssh client, like putty:
+<pre>
+ssh bcmeter@bcMeter
+# or: ssh bcmeter@bcMeter.local
-address: bcMeter
+# Download and run installer
+wget -N https://raw.githubusercontent.com/bcmeter/bcmeter/main/install.sh && sudo bash install.sh
+</pre>
-login name: bcmeter
+This runs an unattended installation taking a few minutes.
-login passwort: bcmeter.org (or whatever you chose)
+== Current Platform (ESP32) ==
-'''If connections is refused, check connection first and then try to add .local to hostname (bcmeter.local)'''
+The ESP32-based bcMeter comes with firmware pre-installed. Setup only requires:
-Then just download the bcMeter install script by entering
+# Plug in power
-       wget -N https://raw.githubusercontent.com/bcmeter/bcmeter/main/install.sh && sudo bash install.sh
+# Connect to the "bcMeter" WiFi hotspot
+# Open <code><nowiki>http://bcmeter.local</nowiki></code>
+# Follow the [[Setup#Welcome Screen|Welcome Screen]]
-This will take you through a mainly unattended install procedure which will take a few minutes
+See [[Setup]] for detailed instructions.