Skip to content

What is xlm.sh? ​

The last mile of Stellar dApps.

Why do we need xlm.sh? ​

Most browsers cannot open IPFS content or resolve Soroban Domains on their own. xlm.sh bridges that gap: it lets anyone open a site or dApp hosted on IPFS/IPNS at a normal HTTPS address, your-name.xlm.sh, without installing anything.

How does xlm.sh work? ​

xlm.sh is a reverse proxy for Soroban Domains and IPFS content.

  1. A wildcard DNS record sends every *.xlm.sh request to the xlm.sh gateways.
  2. The gateway looks up your-name.xlm in the Soroban Domains registry to find the Stellar account it points to.
  3. It reads that account's xlm.sh data entry, which holds an IPFS CID or an IPNS name.
  4. It fetches the content from its own IPFS node and returns it over HTTPS.

All lookups go through Stellar RPC, and each gateway can use several RPC servers, so a single provider being down does not take sites offline. Lookups are cached briefly: a change to your record shows up within a minute or two.

Sites that are visited through xlm.sh are pinned on xlm.sh's own IPFS nodes. This keeps them fast, but it is not a hosting guarantee: keep your content pinned yourself as well (see How to set up a site).

Security and privacy ​

  • Every site is served from its own origin (your-name.xlm.sh), so sites cannot read each other's cookies or storage.
  • Responses carry hardened browser headers, for example X-Content-Type-Options: nosniff, Referrer-Policy: strict-origin-when-cross-origin, and framing limited to the site itself.
  • Traffic is encrypted with TLS 1.3 (or TLS 1.2 for older clients) through Cloudflare, and between Cloudflare and the gateways as well.
  • The gateways do not log visitor IP addresses. They record which sites are visited, without any visitor information, so those sites can be pinned. Cloudflare, which sits in front of xlm.sh, keeps its own logs under its own policy.

Who is responsible for a site ​

Each site is published by the owner of its Soroban Domain, not by xlm.sh, and xlm.sh does not review it. Sites that break the acceptable use rules, such as phishing pages, are blocked when they are reported. Report one to [email protected]. xlm.sh will never ask for your secret key.

Acknowledgements ​

xlm.sh is deeply inspired by eth.limo. Many of the ideas behind xlm.sh, and parts of this documentation, come from the eth.limo team's work. Thank you to everyone who contributed to eth.limo.