Gateway for .xlm websites

Introducing xlm.sh

Posted on Oct 9, 2024

xlm.sh is a gateway for websites running on Stellar+IPFS.

If you set an IPNS/IPFS record in your Stellar/Soroban name, you can access the IPNS/IPFS website by appending .sh to your .xlm name.

Here are a few examples:

  1. blend.xlm.sh
  2. tansu.xlm.sh
  3. overcat.xlm.sh
  4. xlmsh.xlm.sh

How to use xlm.sh

To access your IPFS website through xlm.sh, you only need to follow these two steps:

  1. Add IPFS or IPNS record to your Stellar account through ManageDataOperation.

    For IPFS CID, if your IPFS CID is bafybeih6rtnvdyxqgadoo5tjhkcgnccngkmhhfn2n7knmt2ufo5xdik2de, you need to use the ManageDataOperation to set the ipfs key in your account’s Data Entry to this value.

    For IPNS, use the ipns key instead. For instance, if your IPNS is k51qzi5uqu5dhja04r3z70f0gt4nfw2on0b75wih8xy8nrawutt3ofgoh9osto, set the ipns key to this value.

    For DNSLink, if you have a TXT record with the name _dnslink.web3.example.com and the value dnslink=/ipfs/QmW2WQi7j6c7UgJTarActp7tDNikE4B2qXtFCfLPdw8rWK, you can set the ipns key to web3.example.com.

    If you encounter any difficulties during this process, you can refer to this transaction, which sets an IPNS record for an account.

    Please note that when both IPFS and IPNS records exist, IPFS takes precedence.

  2. Now, let’s take it a step further. Register a domain name on Soroban Domains and set its Address to point to the Account ID you used in the previous step. This way, you can access your website through {your_domain}.xlm.sh.

🎉 That’s it! You’re all set. Enjoy your new setup.

If you encounter any issues or have any questions, feel free to reach out to me on Discord at @overcat.me.