Documentation
Start9 Docs
Support
FAQ
Contribute
Report an EmbassyOS issue
Report a Docs issue
Edit this page
Learn how to contribute
FAQ
¶
Answers to Frequently Asked Questions from Embassy users
General FAQ
What is Start9 Labs?
What is Embassy?
Why do I care?
How does Embassy work?
What is embassyOS?
What are embassyOS Services?
Does the Embassy ship worldwide?
Does the Embassy have international electrical plugs?
Is the power supply that comes with Embassy 220v compatible?
Is the software Open Source?
Can you tell me about the License?
Is there a product warranty?
What kind of Internet connection is required to use Embassy?
I run a business, can I use an Embassy for tasks such as password management and file sharing?
What are you using for a store backend? Do you store my data?
I want to help, but I’m not a developer. Are there any ways for non-coders to contribute?
Embassy FAQ
Can I run embassyOS on a VPS or VM?
Is it possible to use embassyOS on my own hardware?
Do I plug my Embassy into my computer?
Do I plug in a monitor, keyboard, and mouse?
How much storage does Embassy have?
Are my Internet requests anonymous and secure?
Does Start9 have access to my Embassy’s encryption keys?
Can multiple Embassies be setup to run redundantly in physically separate locations?
How does Embassy compare to other Bitcoin nodes or personal servers?
Would you consider (Umbrel, Nodl, RoninDojo, etc) a competitor to Embassy, or are they different enough to be compatible?
How can I migrate from Umbrel to Embassy and keep my lightning channels intact?
Can I mine Bitcoin with this?
Does Embassy only work over Tor? No http or VPN?
What if someone gets physical access to my device, can they read the contents? Is it encrypted?
Why http and not https for .onion websites?
Basic Use FAQ
Is it easy to use?
So I can run my own cloud?
Can I run multiple Embassies?
Can I still use my VPN?
What if I forget my Embassy password?
My Embassy is set up, now what?
Can I move my Embassy to another location? What happens when I do this?
What’s the advantage of using the .local address over the .onion address?
Can I use the .local addresses over the Tor Browser?
Can I use .local addresses on Android?
Can I have multiple users on my Embassy?
What can I do if I am having issues connecting to a mobile app over Tor?
If I uninstall a service, then re-install it, does any data remain?
Do I need to delete existing backups before doing a new backup? Or does a new backup override the old backup?
Can I clone my Embassy SSD for backup purposes?
Why would I even buy this when I can just build it for free?
I bought an Embassy before Q3 2022 and it came with a ‘product key,’ what is that?
Setup and Troubleshooting FAQ
What do I do first?
How do I know if my Embassy is running?
My Embassy is really hot! Is this normal?
I’m trying to migrate my old Embassy data, but the device won’t boot. What do I do?
I cannot reach embassy.local after hearing the start-up sounds from Embassy. What do I do?
Why do I need the Bonjour service (Windows)?
My Tor sites aren’t loading, what should I do?
Do I need to take any additional security precautions with my device, for example with my router/modem?
What if I have an unique network issue, for example, with a firewall?
Can I use my Embassy from behind a VPN, for example, if my router has a built-in VPN?
Is it true that my device has some limited functionality in regard to Embassy?
Contributing FAQ
How can I contribute to embassyOS?
Do I need to be a professional developer or have coding experience to contribute?
Bitcoin FAQ
Why does the Bitcoin service take so long to be ready?
Can the IBD (Initial Block Download) be made faster? Or can wait times be improved?
Does the Embassy run a full archival Bitcoin node or a pruned one?
What actions, specifically, are only possible with an archival, or ‘unpruned’ node?
Is it insecure to run a pruned node?
The Bitcoin Service is different from the GUI version I am used to using (bitcoin-qt). How do I use this like I used to?
Is a wallet vulnerable to hacking if it’s always online??
How does Bitcoin Proxy request (and verify) data when that data is needed by some app using it?
How do I use Bitcoin Core as a wallet?
Which wallets can I use that sync with my Embassy Bitcoin and/or Lightning nodes?
I want to use my hardware signer, such as Coldcard or Trezor, with my Embassy. How does this work?
The Lightning Network FAQ
Why would I want to run a lightning node?
How can I get started with Lightning and open my first channel?
I opened a Lightning channel, but my local balance is lower than I expected. Where is the remainder?
How is that fee estimation calculated?
What would happen if I shut down an Embassy that is running a Lightning node with open channels?
Is there a solution to this?
Is it possible to run Core Lightning and LND in parallel on Embassy?
How do I connect my Lightning wallet or mobile app to my Embassy?
Are my addresses, channels, and balances all stored in LND or in RTL? Core Lightning or Spark, etc?
How do I find my LND seed so I can write it down to backup?
Is there a way to use the channel backups made within RTL?
When attempting to add new peer, RTL says “server is still in the process of starting,” but chain state seems to be fully up to date. What can I do?
I get an error (“Unlock Wallet Failed”) when trying to log in to RTL, what can I do?
“Server is still in the process of starting,” but LND and RTL are running. How can I address this?
I get the following error from LND: “Error ECONNREFUSED Fetching Info Failed! Unknown Error.” What’s wrong?
What’s the best way to move a small lightning balance?
Why are Lightning Network backups and moves so complicated?
Services FAQ
What if I cannot connect to a Service?
Can it be used as a firewall?
Will there be a VPN?
Will there be an email server?
Can the Embassy run ‘X’ Service??
Does the Embassy operate as a Tor relay node?
Are files on File Browser encrypted on disk?
Can others use my Cups instance? How does that work?
How can I fix issues with Sphinx?
I get an error (“Unlock Wallet Failed”) when trying to log in to RTL, what can I do?
What is happening if I cannot connect with another user on Mastodon?
What does it mean when Vaultwarden says “This browser requires HTTPS to use the web vault” upon creating an account or loging in to my Vaultwarden onion?
Can the browser extension be used with Bitwarden hosted on the embassy?
I want to use BTCPayServer on my website, but Tor is the only option, how can visitors access my BTCPay on clearnet?
I’m having issues connecting to users or rooms in Matrix/Synapse, what can I do?
My Element desktop client stopped working after an OS update, what is happening?
I don’t see an answer to my question regarding a certain service. Is there more documentation?
I want to understand in depth how a Service works and it’s available configuration options. Where can I go to learn more?
Packaging FAQ
Do I need programming experience to package a service for embassyOS?
What considerations are there when choosing a service for packaging?
What if I don’t need a Config in my service?
How can my service access the data directory of another service?
Why am I getting the error “No rule to make target yq, needed by manifest.yaml?”
PREVIOUS
Common Issues
NEXT
General FAQ
User Manual
Initial Setup
Connecting
Lan
Tor
Dashboard Overview
Updating embassyOS
Backups
Backup
Restore
Flashing
Flashing (Raspberry Pi)
Flashing (x86)
Flashing (Firmware)
Reset Your Password
Customize
Managing Services
Service Guides
Bitcoin
Lightning
Matrix
Nextcloud
Vaultwarden
Session Management
Setting up WiFi
Using SSH
Alt Marketplaces
Device Guides
Linux
Mac
Windows
Android
iOS
Known Limitations
Upgrade Hardware
Pro upgrade
NASPi upgrade
SSD upgrade
Upgrade Kit
DIY Hardware
Support
Common Issues
FAQ
General FAQ
Embassy FAQ
Basic Use FAQ
Setup and Troubleshooting FAQ
Contributing FAQ
Bitcoin FAQ
The Lightning Network FAQ
Services FAQ
Packaging FAQ
Contact Us
External Support
DIY
DIY Guide (Raspberry Pi)
DIY Guide (x86)
Learn
Concepts
Open Source
Networks
Hosting
Embassy Devices & eOS
Bitcoin and Lightning
Contribute
Create Content
Provide Support
Decentralize
Promote
Developer Docs
Service Packaging
Specification
Dockerfile
Manifest
Config Spec
Properties
Dependencies
Backups
Instructions
Package Bundle
Wrapper
Makefile
JS Procedure
Submission Process
Compat Image
Checklist
Advanced
Dev Tools
master
0.3.2.x
0.3.1.x
0.2.x
master