You are not reading the latest stable version of this documentation. If you want up-to-date information, please have a look at master.
Connect your Embassy to power and Ethernet.
To avoid networking issues, it is recommended to use your primary router, not an extender or mesh router.
If there is something wrong with your hardware setup, such as ethernet being unavailable, you will hear this sound:
If all is well, you will hear 2 distinct sounds:
“bep” - Starting up
“chime” - Embassy is ready
If you followed the DIY guide and built embassyOS from source code, it may take up to 20 minutes to first initialize.
Ensure the device you are using (desktop/laptop or mobile) is connected to the same network as your Embassy.
Sometimes a router will have a “guest WiFi network,” which might be different than the network your Embassy is placed on via ethernet.
Visit http://embassy.local from your web browser.
Select “Start Fresh”
The “Recover” button is used for migrating from 0.2.x or restoring from backup.
Select your storage drive. There should only be one drive in the list.
Create a master password for your Embassy and click “Finish”.
Choose a strong master password. Write it down. Store it somewhere safe. DO NOT LOSE IT.
The drive will be initialized for a few minutes
Your Embassy is now a private website on the private web! Continue to the section on Connecting to learn more about using your Embassy over Tor and LAN.
Click “Download This Page” to save your Embassy address and certificate info on your computer.
If you are experiencing issues with setup, try the following:
Confirm that the Embassy is plugged into both power and Ethernet
Confirm the Embassy emitted two sounds when powering on: a bep and a chime
Confirm your phone/computer is not connected to a “Guest” network
Confirm your phone/computer is not using a VPN
Refresh the embassy.local browser page
Very rarely, a router may not support mDNS. In this case:
From your browser, navigate to your router configuration settings. This is usually an IP address such as 192.168.1.1. A simple web search will usually reveal how to access the router configuration settings for a particular brand.
Once in the router config settings, find the section that lists the devices on your network. You should see an item labeled “embassy”. Take note of the associated IP address and enter it into your browser’s URL field to enter the setup.
If you are still having issues, please contact support.