Skip to content

Commit c229735

Browse files
authored
[Documentation:Developer] Fedora VM installation instructions (#575)
Added Fedora Linux/RHEL install instructions for vagrant and VirtualBox to the Submitty.org developer page, as well as a few common issues.
1 parent af344f6 commit c229735

File tree

1 file changed

+34
-0
lines changed

1 file changed

+34
-0
lines changed

_docs/developer/getting_started/vm_install_using_vagrant.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -147,6 +147,40 @@ Below are quick steps to get everything installed and running.
147147
Vagrant: <https://developer.hashicorp.com/vagrant/downloads>
148148
(if that doesn't work, try: <https://vagrant-deb.linestarve.com/>)
149149
150+
**Fedora/Red Hat Linux**
151+
152+
* For Fedora, the latest version of VirtualBox is recommended to prevent errors. Download the RPM from the virtual box website. Make sure your version of
153+
Fedora is up to date using
154+
```
155+
sudo dnf update
156+
sudo dnf upgrade
157+
```
158+
and inputting your password. Then install the Virtual Box rpm using:
159+
```
160+
sudo dnf install VirtualBox-xxxxx.rpm
161+
```
162+
Install Vagrant using:
163+
```
164+
sudo dnf install vagrant
165+
```
166+
Now move on to step 5.
167+
168+
**NOTE**
169+
when running vagrant up, use `vagrant up --provider=virtualbox` so it doesnt default to libvirt
170+
171+
**Common errors when running vagrant up(Fedora/RHEL)**
172+
1. Missing virtnetworkd:
173+
Enable it in your terminal by running:
174+
```
175+
sudo systemctl start virtnetworkd
176+
```
177+
2. If your vagrant ever freezes kill it with
178+
'''
179+
VBoxManage controlvm VM_NAME poweroff
180+
'''
181+
or if that doesn't work, reboot the computer and then run `vagrant destroy` before re-running `vagrant up --provider=virtualbox` again.
182+
183+
150184
5. Clone [the Submitty repository](https://github.com/Submitty/Submitty) to a location on
151185
your computer (the "host").
152186

0 commit comments

Comments
 (0)