steve
/
unRedbox-Wiki
mirror of https://github.com/unRedbox/Wiki.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs: update manual/applications

This commit is contained in:
briannw 2024-12-08 20:05:45 +00:00 committed by Redbox Wiki
parent 499ca19be7
commit 12501104dc
1 changed files with 14 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
manual/applications.html
View File

@ -2,13 +2,24 @@
title: Useful Applications
description:
published: true
date: 2024-12-08T12:59:34.669Z
date: 2024-12-08T20:05:44.043Z
tags:
editor: ckeditor
dateCreated: 2024-12-08T12:59:34.669Z
-->
<h2>Installing VNC Server</h2>
<p>to-do: content</p>
<p>If you've recently acquired a Redbox kiosk and want to tinker with your machine in the comfort of your own room, you may want to look into setting up a VNC server. A VNC server will allow you to remotely access and control your kiosk from any device, anywhere, which can save you the hassle of connecting a keyboard and mouse each time you need to access the machine. This is especially useful if your kiosk is placed in a less convenient location, like outdoors or in a cold garage. To start a VNC server on your kiosk, you'll need to choose one first. UltraVNC is highly recommended, as it works great on 32-bit devices and is easy to setup. First, <a href="https://uvnc.com/downloads/ultravnc.html">visit this page</a> to download the latest version of UltraVNC Server (make sure to select the 32-bit architecture). Then, drag this executable on a USB stick and plug it into your kiosk.</p>
<p>Once you boot your kiosk, open the File Explorer and navigate to your external USB. Click on the executable to start the installation, and follow the instructions to set up your VNC server. When the installation is complete, navigate to <code>C:\Program Files\uvnc bvba\UltraVNC</code> and launch the <code>uvnc_settings.exe</code> file located in this folder. Here, you'll be able to configure your VNC server and setup a password for accessing it.</p>
<p>Then, apply all changes and restart your system. Once your system boots back up, you should be able to access your VNC Server at port 5900 (by default). Download a VNC Client on your devices (like RealVNC Viewer), and enter your kiosk's local IP address followed by the port. You should be able to connect without issues and access your kiosk on your network!</p>
<p><strong>Tip: </strong><u>If you want to access your kiosk outside of your network, you can setup port forwarding on your router to expose the 5900 port.</u></p>
<h2>Enabling SMB Protocol</h2>
<p>to-do: content</p>
<p>If you'd like to have the option of managing the files on your kiosk with ease, enabling the SMB1 protocol is a good choice. Similarly to setting up a VNC Server, SMB will allow you to access your kiosk's internal files without the need of navigating through File Explorer directly. Before enabling SMB, you'll need to create a new Administrator account or change the password for <code>Rbuser</code> to login. You can learn how to change the default Administrator password <a href="https://redbox.wiki/en/manual/troubleshooting#changing-your-administrator-password">here</a>.</p>
<p>If you already have access to an Administrator account, open the Command Prompt on your kiosk and run the following command to enable SMB through the registry editor:<br><code>reg add "HKLM\SYSTEM\CurrentControlSet\Services\LanmanServer\Parameters" /v SMB1 /t REG_DWORD /d 1 /f</code></p>
<p>This will create a registry record enabling SMB1 on your device. Before you continue, it's also recommended that you ensure SMB will start properly on boot. To do this, enter the Services Manager (<code>services.msc</code>) and look for the following services: <strong>Server</strong>, <strong>Workstation</strong>, and <strong>TCP/IP NetBIOS Helper</strong>. For each of these, right-click them and select Properties, and make sure that the Startup type is set to "Automatic". They most likely are, but if not, make sure to update them as so and start them afterwards if they aren't already.<br><br>Once you've enabled SMB and configured the start-up services, you'll want to grant permission to access the C:\ drive on your kiosk. Navigate to your C:\ drive in File Explorer and right-click on it, then select Properties. Click the Sharing tab, and select Advanced Sharing to open the permission manager. Tick the "Share this folder" option, and create a “Share name” to continue (you can name this whatever you'd like). Click the Permissions button below it, and check Allow for each option (Read/Write/Full Access), making sure the “Everyone” group is selected.</p>
<p>After doing this, you should be able to access your kiosk files through SMB! If you don't know how to do this already, you can use <a href="https://knowledgebase.45drives.com/kb/kb450446-connecting-to-smb-share-on-windows-and-macos/">this guide here</a>. When you're prompted to enter your credentials, use the login for your Administrator account that you setup before you started. That's it!</p>
<h2>Configuring Firewall</h2>
<p>If you want to enable functionalities like starting a VNC server, enabling the SMB protocol, or any other tasks that require a local network connection, you'll want to connect your kiosk to your home network. As you may already know, however, you may not want to expose your computer to the internet directly as it may cause complications in the future when software is no longer supported (or in the case of being required to upgrade Windows 7). To help minimize your risk to such complications, you can configure your router's firewall and disable access to WAN. If you don't have your kiosk connected to the internet already, you can follow the instructions <a href="https://redbox.wiki/en/manual/quirks#no-internet-on-cellular-modem-sim">here</a>.<br><br>To do this, you'll need access to your router's administrator panel. This tutorial will be using OpenWRT, but most router's support this functionality in a similar way (the instructions may vary, however). First, login to your router's OpenWRT interface and go to <strong>Network &gt; Firewall &gt; Traffic Rules</strong>. Then, create a new forward rule with the “Source zone” set to LAN, and the “Destination zone” set to WAN. Then, update this forward rule to the following details:</p>
<blockquote>
<p>Name: [enter any name here]<br>Restrict to address family: <strong>IPv4 and IPv6</strong> (default)<br>Protocol: <strong>TCP+UDP</strong> (default)<br>Source zone: <strong>LAN </strong>(default)<br>Source MAC address: [select your kiosk's MAC address here]<br>Source address: [select your kiosk's local IP address here]<br>Source port: <strong>any </strong>(default)<br>Destination zone: <strong>WAN </strong>(default)<br>Destination address: <strong>any </strong>(default)<br>Destination port: <strong>any </strong>(default)<br>Action: <strong>reject</strong><br><br>Click the <strong>Save &amp; apply</strong> button below, and wait for the changes to propagate. Your kiosk should now have internet access restricted to only communicate devices in your local network.</p>
</blockquote>