Skip to content

Commit 21a3ff8

Browse files
authored
Merge pull request #3 from dogeorg/mdns-docs
Introduce documentation for reaching the dogebox using mDNS domain name
2 parents 172c72d + 15a53cb commit 21a3ff8

File tree

3 files changed

+18
-2
lines changed

3 files changed

+18
-2
lines changed

src/installation/setup.md

+5-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
# Dogebox Initial Setup
22

3+
On the first boot of your dogebox, the system will be available on https://dogebox.local:8080/.
4+
5+
In case your network blocks mDNS, which can happen in some cases use the following methods to determine the IP address of the machine.
6+
37
## Determine your IP address
48

59
<div class="warning">
@@ -24,7 +28,7 @@ Unfortunately this is out-of-scope for this documentation, but a quick google of
2428

2529
## Visit setup UI
2630

27-
Once you've got your IP address, continue setup by visiting the Web UI. This is hosted on port `8080` on the IP address.
31+
Once you've got your IP address or confirmed the box is available on dogebox.local, continue setup by visiting the Web UI. This is hosted on port `8080`.
2832

2933
eg. If your IP address is `192.168.0.2`, you should visit `http://192.168.0.2:8080` in your browser.
3034

src/installation/setup/configuration.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Here we have some basic system configuration options.
1414

1515
#### Device Name
1616

17-
This is what your devices `hostname` will be set to. This may be used for additional features in the future.
17+
This is what your devices `hostname` will be set to. The value chosen here will determine the mDNS address you will be able to access the WebUI with later on. E.g. if you choose `my-dogebox` then you'll be able to access the WebUI at https://my-dogebox.local:8080/.
1818

1919
#### Keyboard Layout
2020

src/installation/t6.md

+12
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,8 @@ You can easly flash using the OpenSource Rufus Tool that you can get the latest
3636

3737
## How to Setup
3838

39+
With a monitor and keyboard available
40+
3941
- Insert the MicroSD card with image flashed.
4042
- Ensure you have an ethernet cable plugged into your T6 box.
4143
- Plug in a HDMI screen, make sure it's plugged into `HDMI1`.
@@ -51,6 +53,16 @@ You can easly flash using the OpenSource Rufus Tool that you can get the latest
5153
- In this example, it would be `http://192.168.1.5:8080` but your IP address will be different.
5254
- This will load the DogeBox Setup page.
5355

56+
Without a monitor and keyboard available
57+
58+
- Insert the MicroSD card with image flashed.
59+
- Ensure you have an ethernet cable plugged into your T6 box.
60+
- Plug power in.
61+
- Wait until the box finishes booting, this could take anywhere from 2 to 10 minutes.
62+
- In a web browser, visit `https://dogebox.local:8080` to start configuring your dogebox.
63+
- This will load the DogeBox Setup page.
64+
65+
5466
<p><img src="../images/vb5.PNG" alt="How to find your IP address" width="70%" style="margin-left:1em;"/></p>
5567

5668
## Restart your Dogebox

0 commit comments

Comments
 (0)