Domain
You can reserve a domain name so that it will never be assigned to another user, even if your tunnel is offline; you can reserve a subdomain of the form
sub.loclx.io
or a totally custom domain like example.com
.loclx domain reserve --subdomain dev
This will reserve the domain
dev.loclx.io
if you want to reserve in another region you need to pass --region ap
for example then the final domain will be dev.ap.loclx.io
.Note that we advice to only reserve first level subdomains like
dev.loclx.io
to avoid TLS issues. For example reserving
dev.app.loclx.io
will have TLS warning when access it.loclx.io
TLS certificate includes only the following:*.loclx.io
*.ap.loclx.io
*.eu.loclx.io
loclx domain reserve --domain example.com --region ap
The command above will reserve
example.com
and it will return a DNS record that you need to add in your domain DNS settings, check THIS tutorial for more information.One of the two flags
--subdomain
or --domain
is required but not both.
loclx domain status --domain example.com
This command will check your DNS if configured correctly, it may take time to see your domain as
verified
due to DNS propagation time.Create a Let's Encrypt certificates for your reserved custom domain is simple with LocalXpose, you just need to run:
loclx domain letsencrypt --domain example.com
This will create a Let's Encrypt certificate and store it in your machine, then you can use the generated certificate in your TLS tunnel.
Please make sure of the following rules:
1. There is no a running tunnel using the domain which you want to issue a certificate for.
2. The port 54538 is free.
Creating Let's Encrypt certificate mostly needed only when you want to use TLS tunnel, HTTP tunnel will automatically generate the certificate for you and handle the renewal too.
You can reserve a wildcard custom domain by doing
loclx domain reserve --domain '*.example.com'
loclx tunnel http --reserved-domain '*.example.com` # or 'anything.example.com`
Last modified 2mo ago