Domain Aliases

[Lonkle]

@girish Wanted to make sure nothing has changed on your end on this feature request, I may find time to squeeze this feature in there when I update my OpenVPN Client code for 6.0. Depends on how difficult it is, but just seems like a slight nginx and a new database entry for aliases. Looks like the UI only has to change slightly as we only need to add "alias" as an option in the Locations tab.

[jimcavoli]

I realize it would break backwards compatibility, but I'm of the mind that aliasing a domain name should be the default and that redirects should be the opt-in. So an app called xyz.cloudron.example with a second location of abc.cloudron.example would be an alias that resolves abc.cloudron.example straight into the xyz.cloudron.example container's web port, and having the option to check a box or something to make an alias like def.cloudron.example redirect so that name when resolved does the 3xx redirect to xyz.cloudron.example. Whichever is the default is fine, I suppose, but that would strike me as more intuitive. Plus, the iconography is a lot easier (various arrow graphics indicate redirect more commonly than any other symbol indicates "not redirect").

[girish]

@jimcavoli Most apps don't support having them hosted on more than one domain. I think WordPress is just very special in this regard. For example, most of the config files of apps only allow setting a single domain name. I assume that the domain name is used in places, otherwise why ask for it all. And since it's used but they only allow for one, I can only assume that most apps don't support more than one domain. I haven't tested it of course, but just guessing from all the config files I have seen

[jimcavoli]

@girish Makes enough sense to me!

[Lonkle]

@girish Would a checkbox to make a domain a Location an "alias" instead of a "redirect" work for you then? Or would you rather I go in a different direction UX wise?

[girish]

@lonk I guess another section named "Alias" would be a good start (just like Redirections).

Is the multi-site WP app already available somewhere? I would think that is probably the biggest showstopper here and not the UI changes itself.

[Lonkle]

@girish said in Domain Aliases:

@lonk I guess another section named "Alias" would be a good start (just like Redirections).

Is the multi-site WP app already available somewhere? I would think that is probably the biggest showstopper here and not the UI changes itself.

There is no "Multisite Wordpress" Version. Multisite is just a feature inside of Wordpress (I set it up on Wordpress Developer very easily). It's a flick of a switch in the Wordpress app, it converts it's database into a multi-blog / multisite DB. Once the DB is converted tho, it can't be reverted to single site.

So, the only show stopper is the fact that another blog within a multisite uses another domain name and Wordpress itself does the routing so with Redirections, there's no way to access any other subsite in your installation because Wordpress is never given the real URL of which to route to.

Does that make sense? That's why Domain Aliases are the only thing needed for this. I have plenty of quality of life changes I've pre-built (which are really just slight additions to the startup script to account for multiple sites so all features work for all sites but 95% of the features work out of the box rn). But without Domain Alias Support even my slight startup script updates to account for multisite (which are outlined in the multisite thread), this feature actually is the show stopper (not the UI of course, but the routing logic) since multisite literally can't work without it (there is a way to use subdirectories, but most don't choose to do that - I'm doing it temporarily while aliases aren't supported within Cloudron).

[girish]

@lonk I see, let me try to understand who WP multi-site works then. I thought we had to auto configure the domains in the package, maybe that's not needed.

[Lonkle]

@girish said in Domain Aliases:

@lonk I see, let me try to understand who WP multi-site works then. I thought we had to auto configure the domains in the package, maybe that's not needed.

Well, that would be out of scope of Cloudron box code. Multiple domains can be set "per site" in a multi-site Wordpress installation and are configurable / editable. Meaning, the user edits their domain and adds one when they add a new site / blog within their multisite installation. Coincidentally, in Wordpress, they're called URL Aliases (you can even give a single post its own domain if you dig deep enough in Wordpress but most use it the default way via the "Sites" tab and adding aliases to their individual sites within the installation).

I'm currently making Cloudron for Wordpress which I'm guessing I'll add more features down the road, but right now it's only function is that it will add any domain alias additions or changes to the parent Cloudron App Container. It's a very simple plugin. Only a few lines. I'd recommend packaging it into Cloudron's Wordpress Installation like you do the SMTP plugin (but as a Must Use plugin to ensure it's always active and cannot be deactivated).

Tbh, because the UI is technically going to be in Wordpress, we don't need any UI changes in dashboard, just an API endpoint for any given Wordpress container to add domain aliases to itself. Adding an API endpoint for a special type of domain location seems well within the scope of box.

[Lonkle]

And as you can see in: https://forum.cloudron.io/topic/4219/pressbooks-ebook-publishing-based-on-wordpress-multisite?_=1610925351271

Plugins can use Wordpress' routing features as they like, so making this one-way sync of domains from with Wordpress to Wordpress Container makes the most sense to be compatible with all plugins.

Also, side note, I've never seen a web hosting platform that didn't make you add a "CPanel Domain Alias" and then a "Wordpress Native URL Alias" in multisite every time you added or edited a site / alias.

It's confused quite a few people, so this also reduces complexity for users coming into multisite. Not even hosts like WP Engine have that kind of domain integration (yet, I'm sure they will as multisite just keeps getting more popular) so this would be quite a differentiator for your platform when it comes to multisite.

[jimcavoli]

@girish The only technical requirement is that the IP gets hit with the corresponding Host header - the stumbling block is just on the reverse proxy's answer of 3xx vs proxy essentially. I think that was your understanding before, and if so, that still holds.

As far as the note about having to add things twice, that's mostly down to still just that DNS point easier and the second add would generally be to reconfigure the underlying apache running WP (and why WP Engine et al generally require a manual step). In the cloudron case though, we can just have a wildcard server and move on since this isn't a cPanel or similar environment and we do have the reverse proxy and other features keeping the final upstream links "clean." The "traditional" model for this is a server at x.x.x.x with one or many subdomains using that x.x.x.x in their A records.

[Lonkle]

@jimcavoli So, what are you proposing we do differently then a Wordpress-based one-way sync method? We could do it the other way around.

Or we could also just have the user configure their custom domain in both places (in Cloudron as an Location Alias, and in Wordpress as a URL Aliases - tho I don't like this option if only due to common user error).

[Lonkle]

@jimcavoli Or were you just explaining that having the reverse proxy send the correct domain header to the container is all that's needed to support Wordpress Multisite? If so, that's true.

we can just have a wildcard server

Wordpress Multisite supports multiple (as many as you want) top level domains, so wildcards in this scenario don't make sense to me.

[girish]

@jimcavoli @Lonk OK, I learnt a bit more about WP multisite now and tested it on Cloudron! As you said, it's really just a matter of putting a line in the wp-config and then enabling network settings in the WP admin.

I think it's quite straight forward to do something like this:

• Add a multiDomainflag in the manifest
• When present, you can add additional domains in the Location section.

Both the above are trivial to add. In fact, the nginx configuration required for the primary domain and the alias domain is the same as well, so it's easy to generate them.

However, I am stuck with one thing. It seems what WP wants really is *.domain.com (though the actual full domain can be edited after adding the site). I guess this means we should add some check box like Alias all subdomains to this app ? Internally, this will setup *.domain.com as an alias. This requires us to fix the programmatic DNS backends to support '*' as the location but this should not be hard (but a bit of work testing each backend).

Finally, I think this approach will also work for GitLab pages! (cc @atrilahiji and @mario )

[girish]

I have pushed an initial implementation for this now. Essentially, you can add aliases which can be a wildcard or any other domain on Cloudron. As always the DNS, cert setup etc are all automated. I have checked with WP multisite and it works well (I am sure there are possibly package tweaks we have to do further). I will test EspoCRM and GitLab pages tomorrow.

[marcusquinn]

@girish Cloudron simplicity - love it!

[jimcavoli]

This would also enable the Dolibarr CMS to work as well well, in theory. Worth checking on that one too

[girish]

@marcusquinn I tested with EspoCRM portals today and it works well!

[marcusquinn]

@girish Brilliant Espo Portals are going to be a game-changer for me, I'm looking at Espo as a rapid web-app development for business, almost can't believe I overlooked it for so long.

[Lonkle]

@girish said in Domain Aliases:

I have checked with WP multisite and it works well (I am sure there are possibly package tweaks we have to do further).

You da man! This was the big box change to make it all possible. There are some subtle Multisite changes, that I'll submit as PR to WP Developer and WP Managed. They involve:

1. Upgrading the databases of all subsites on on WP Update (by default, it only upgrades the primary sites database on upgrades and overlooks sub-sites which can cause conflicts) - and this requires only a few WP-CLI lines of code after a WP Update (it detects version changes and upgrades all sub-site databases right away to prevent any sites getting out of sync from the primary sub-site which automatically has it's database upgraded when needed).

2. The default WP-Cron script included in Cloudron's package runs every minute and disables Wordpress built-in Cron. Sub-sites need to be accounted for when disabling cron, and luckily, I wrote another WP-CLI that loops and runs the Cron Queue for each sub-site (if they exist).

3. (Optional) I'm writing a "Cloudron for Wordpress" Must Use plugin to make sure if a domain gets changed from within Wordpress, it adds the new domain to the list of aliases in app locations within Cloudron's Dashboard. I see you added an API endpoint for this so it'll be easy enough for me to do, though a user will have to enter in a login token or app token into the WP plugin (UNLESS you'd like to automate this on install).