Web3 Hosting on Aleph.im
Overview
Aleph.im offers web3 hosting services via the Twentysix Cloud Console, allowing you to deploy any kind of Dapps in few simple steps. Your websites are stored on IPFS and are fully-managed by the Aleph network.
Aleph.im being GDPR-compliant, if you decide to delete your website, or some older versions of it (previous deployments), or if you stop holding the required amount of tokens to keep it online, your website will be automatically garbage collected after a grace period by our network.
ℹ️ IPFS being a public P2P network, your files may still be available over the network if external nodes pinned them.
Getting started
Prepare
You need to provide a root folder containing your static website's files.
Simple Static Website
The minimal requirement is that your folder must contain an index.html
file. This file will always be the entrypoint of your website.
Framework-based Website
We are listing the officially supported frameworks on TwentySix's website creation page, but you can actually use any framework (and package manager, such as npm, pnpm, yarn, bun...) to create your website.
ℹ️ Keep in mine that your website, being a decentralized frontend, must only contain client-side components, as well as the dependencies used by it. For backend support, check out the section below.
Build
When your project is ready, you can build and generate your static folder. Example using npm:
ℹ️ The name of the output folder depends on the framework used, it's usually
out
ordist
.
Deploy
When your static folder is ready, you can deploy your website using the Twentysix Cloud Console.
History and Updates
You can update your website or access/redeploy previous versions easily through your Website Management Dashboard.
Access Your Dapp
Aleph Gateway Service
When your website is live on Aleph network, we provide you a gateway url to easily access it:
https://{ipfs-cid-v1}.ipfs.aleph.sh
You can also access it in a similar fashion using alternative gateways, since your website is hosted on IPFS. Find alternative gateways here.
Custom Domains
At deployment time, or later, you can link a custom domain to your website using:
ENS Domains
Since your website is hosted on IPFS, it is compatible with ENS domains.
To resolve it:
- Access your domain page on ens.domains
Records
➜Edit Records
➜Other
- Setup
Content Hash
to:ipfs://{ipfs-cid-v1}
Your website will then be accessible via:
https://{ens-domain}.eth.limo
or
https://{ens-domain}.eth.link
Advanced Features
Handle Redirections on IPFS
By default, IPFS can't handle any fallback redirections, so we provide a 404 fallback
for all routes that are not found.
If you want to add more specific redirections, you must create a _redirects
file into your dapp:
- Simple website: It should be located in the root folder.
- Framework-based website: it should be located in the
public
folder. At build time, it will be moved at the root.
Check out the IPFS documentation below for more details.
Useful Links
Backend Support
In order to add a backend to your website and to make it a complete fullstack dapp, there are currently 2 different approchs you can implement:
- Deploy your backend as a function using our serverless solution.
- Deploy your instance then setup your environment and expose your APIs to the internet.
ℹ️ You should setup your backend in advance, in order to integrate the needed endpoint urls inside your website after.
Auto-Deployment on Push
Coming soon.
Troubleshooting
aleph-sdk-ts
When using the Typescript SDK, some frameworks can require a specific setup.
Found an issue?
If the documentation didn't help, you can report an issue.