Build README and Success page updates (#1024)

* added clarification on the embassy.local address being turned off after successful setup.

* adding troubleshooting section to README.md file.

* removing duplicate information

* updates per PR review.
This commit is contained in:
Alex Yong
2022-01-05 14:32:13 -05:00
committed by Aiden McClelland
parent efd168a830
commit 6417a14aa3
2 changed files with 21 additions and 0 deletions

View File

@@ -53,3 +53,20 @@ We recommend [Balena Etcher](https://www.balena.io/etcher/)
Visit http://embassy.local from any web browser Visit http://embassy.local from any web browser
We recommend [Firefox](https://www.mozilla.org/firefox/browsers) We recommend [Firefox](https://www.mozilla.org/firefox/browsers)
## Troubleshooting
1. I just flashed my SD card, fired up my Embassy, bootup sounds and all, but my browser is saying "Unable to connect" with embassy.local.
- Try doing a hard refresh on your browser, or opening the url in a private/incognito window. If you've ran an instance
of Embassy before, sometimes you can have a stale cache that will block you from navigating to the page.
2. Flashing the image isn't working with balenaEtcher. I'm getting `Cannot read property 'message' of null` when I try.
- The latest versions of Balena may not flash properly. This version here: https://github.com/balena-io/etcher/releases/tag/v1.5.122 should work properly.
3. Startup isn't working properly and I'm curious as to why. How can I view logs regarding startup for debugging?
- During the Build step, instead of running just `make` run `ENVIRONMENT=dev make`. Flash like normal, and insert into your Embassy. Boot up your Embassy, and on another computer
on the same network, ssh into the Embassy with the username/password `ubuntu`. After logging in and changing the password, run `journalctl -u initialization.service -ef` to view the start up logs.
4. I need to reset my password, how can I do that?
- At the time of writing, there is no way to do that in 0.3.0 cleanly. You'll need to reflash your device unfortunately.

View File

@@ -76,6 +76,10 @@
<a href="https://docs.start9.com/user-manual/general/lan-setup.html" target="_blank" rel="noreferrer"><b>here</b></a>. <a href="https://docs.start9.com/user-manual/general/lan-setup.html" target="_blank" rel="noreferrer"><b>here</b></a>.
</p> </p>
<p>
<b>Please note, once setup is complete, the embassy.local address will no longer connect to your Embassy.</b>
</p>
<ion-button style="margin-top: 24px; margin-bottom: 24px;" color="light" (click)="installCert()"> <ion-button style="margin-top: 24px; margin-bottom: 24px;" color="light" (click)="installCert()">
Download Root CA Download Root CA
<ion-icon slot="end" name="download-outline"></ion-icon> <ion-icon slot="end" name="download-outline"></ion-icon>