Skip to content

Commit 571c7d2

Browse files
authored
Feature/update network boot instructions (#96)
1 parent d64b3f3 commit 571c7d2

File tree

1 file changed

+49
-21
lines changed

1 file changed

+49
-21
lines changed

docs/Running-ROMs-from-a-Network-Share.md

Lines changed: 49 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -13,52 +13,70 @@ For EmulationStation to be able to see your rom files the paths given to it with
1313

1414
If you prefer to not use the EmulationStation system directory names and keep the current folder structure you have on your networked server you'll need to edit `es_systems.cfg`. Use this command to copy the configuration file to the home directory wherein it will be editable through SMB (//RETROPIE/configs/all/emulationstation) or FTP.
1515

16-
cp /etc/emulationstation/es_systems.cfg /home/pi/.emulationstation/es_systems.cfg
16+
```bash
17+
cp /etc/emulationstation/es_systems.cfg /home/pi/.emulationstation/es_systems.cfg
18+
```
1719

1820
## Mount your Share
1921

2022
If you haven't already, now is a good time to tell Raspbian to wait for your network at boot.
2123

22-
sudo raspi-config
24+
```bash
25+
sudo raspi-config
26+
```
2327

24-
In there, select "Boot Options" and tell it Yes.
28+
In there, select System Options->Network at Boot and tell it Yes.
2529

2630
### Option 1: Add to autostart.sh (Preferred if using v4.0+)
2731

28-
sudo nano /opt/retropie/configs/all/autostart.sh
32+
```bash
33+
sudo nano /opt/retropie/configs/all/autostart.sh
34+
```
2935

3036
Add the following line to the top of that file, being sure to adjust it for your personal settings, paths and options. This will make the local roms folder use your remote server roms folder instead.
3137

32-
sudo mount -t cifs -o username=something,password=something,nounix,noserverino //REMOTEHOST/path/to/roms /home/pi/RetroPie/roms
38+
```bash
39+
sudo mount -t cifs -o username=something,password=something,nounix,noserverino //REMOTEHOST/path/to/roms /home/pi/RetroPie/roms
40+
```
3341

3442
> **Good to know**: If you'd like to host the entire RetroPie folder remotely you can do so by removing the `/roms` directories from the mount command above. Make sure to have a copy of the RetroPie installation on your remote server or EmulationStation won't be able to start RetroPie!
3543
3644
Restart your Raspberry Pi with `sudo reboot`.
3745

3846
Alternatively, if you have a shared folder that allows guest access, you can use the following line in your `autostart.sh`:
3947

40-
sudo mount -t cifs -o guest,uid=pi,nounix,noserverino //hostname/retropie /home/pi/RetroPie
48+
```bash
49+
sudo mount -t cifs -o guest,uid=pi,nounix,noserverino //hostname/retropie /home/pi/RetroPie
50+
```
4151

4252
This should also allow you to write save files to your NAS.
4353

4454
### Option 2: Add to fstab
4555

4656
Using your favorite editor, open up fstab:
4757

48-
sudo nano /etc/fstab
58+
```bash
59+
sudo nano /etc/fstab
60+
```
4961

5062
Add the line to mount your network share. Mine looks like this:
5163

52-
//192.168.1.10/Storage/ROMs /home/pi/RetroPie/roms cifs username=Username,password=Password,nounix,noserverino,defaults,users,auto 0 0
64+
```bash
65+
//192.168.1.10/Storage/ROMs /home/pi/RetroPie/roms cifs username=Username,password=Password,nounix,noserverino,defaults,users,auto 0 0
66+
```
5367

5468
First, make sure it will mount:
5569

56-
sudo mount -a
70+
```bash
71+
sudo mount -a
72+
```
5773

5874
Restart and check the folder to make sure it didn't have any issues mounting at boot
5975

60-
sudo reboot
61-
sudo ls RetroPie/roms/snes
76+
```bash
77+
sudo reboot
78+
sudo ls RetroPie/roms/snes
79+
```
6280

6381
With any luck (and if you have a ton of SNES ROMs like myself), it will be fairly apparent that it was able to mount the share at boot.
6482

@@ -68,23 +86,28 @@ This will give you read/write access, so you could keep your saves there as well
6886
First [create an account on your Time Capsule](https://discussions.apple.com/message/6801520#message6801520) with the same credentials as your Pi (default: pi/raspberry).
6987

7088
Install `cifs-utils` if it's not already installed
71-
```
89+
90+
```bash
7291
sudo apt update && sudo apt install cifs-utils
7392
```
93+
7494
Edit your `autostart.sh` file
75-
```
95+
96+
```bash
7697
sudo nano /opt/retropie/configs/all/autostart.sh
7798
```
78-
And instead of
79-
```
99+
100+
And instead of
101+
102+
```bash
80103
sudo mount -t cifs -o username=something,password=something //hostname/retropie /home/pi/RetroPie
81104
```
82-
you enter
83-
```
84-
sudo mount -t cifs //hostname/retropie -o username=USERNAME,password=PASSWORD,sec=ntlm,file_mode=0777,dir_mode=0777 /home/pi/RetroPie
85-
```
86105

106+
you enter
87107

108+
```bash
109+
sudo mount -t cifs //hostname/retropie -o username=USERNAME,password=PASSWORD,sec=ntlm,file_mode=0777,dir_mode=0777 /home/pi/RetroPie
110+
```
88111

89112
## Troubleshooting
90113

@@ -104,15 +127,20 @@ I started a discussion on the forums for this article. I haven't written any gui
104127

105128
If you are getting permission denied errors when you try to scrape or save states, try editing your autostart.sh and replacing:
106129

107-
sudo mount -t cifs -o username=something,password=something //REMOTEHOST/path/to/roms /home/pi/RetroPie/roms
130+
```bash
131+
sudo mount -t cifs -o username=something,password=something //REMOTEHOST/path/to/roms /home/pi/RetroPie/roms
132+
```
108133

109134
with
110135

111-
sudo mount -t cifs -o sec=ntlmv2,username=something,rw,file_mode=0777,dir_mode=0777,password=something,nounix,noserverino //REMOTEHOST/path/to/roms /home/pi/RetroPie/roms
136+
```bash
137+
sudo mount -t cifs -o sec=ntlmv2,username=something,rw,file_mode=0777,dir_mode=0777,password=something,nounix,noserverino //REMOTEHOST/path/to/roms /home/pi/RetroPie/roms
138+
```
112139

113140
This will give you write access and should solve your problem.
114141

115142
> **Good to know**: Most problems with samba shares running on Windows are due to the fact that Windows 10 now no longer supports SMB1 by default. Ensure that you have a user setup on Windows with the credentials given, and that you have granted user access by right-clicking the shared folder and selecting the user from the 'Give Access To...' selection menu.
116143
117144
## Thank You
145+
118146
Thank you, everyone at the Raspberry Pi foundation, everyone involved in the development of EmulationStation and RetroPie, authors of several guides that I can't recall the names of, @sselph, @BuZz and probably a few other people.

0 commit comments

Comments
 (0)