Agate+ (dual protocol server to serve gemini/http from one source)

[LoudLemur]

amazing effort and engrossing to read your development report. thank you! will test later...

[nebulon]

@timconsidine nice work, so basically one app which runs on the default port does the same thing for gemini, what nginx on port 80/443 does for http. The probably only more elegant way to get around this would be to run a gemini reverse proxy directly as a service on Cloudron. Given that gemini:// is quite the geeky fringe protocol for the moment, I think your solution is best suited. If you want, I will look into your package and see what further needs polishing for adopting into the main app libarary then.

[nebulon]

Just some random things, which popped up while glancing over the current package:

Instead of https://git.cloudron.io/timconsidine/cloudron-agate-plus/-/blob/master/start.sh?ref_type=heads#L52 you could just place the logfile into /run/.. and Cloudron will actually run logrotate for you out of the box: https://docs.cloudron.io/packaging/cheat-sheet/#logging

For the http server, which is currently run as a background job of the start.sh via node /app/code/proxy.js & it would be better to use supervisord for this and also the gemini server. The reason being that if one of the processes crash, they would get autorestarted by supervisor. Without that the app would require a manual restart by an admin to restart that node process internally.

Otherwise this is already looking really good!

[timconsidine]

Thank you for the pointers @nebulon
I’m away delivering aid for Ukraine, so will get on to this when I’m back.

[LoudLemur]

I haven't got round to testing the latest agate+ yet, but one thing I can say for sure:

It was far easier to convert our astro starlight documentation to gemini-protocol format and publish them using agate as a gemlog than it was to try and publish via cubby, which we still haven't managed!

[timconsidine]

@LoudLemur
I will make and publish an image after the final tweaks.

[timconsidine]

New version of the app uploaded to https://git.cloudron.io/timconsidine/cloudron-agate-plus

CHANGELOG :

• implemented @nebulon suggestion about logs rotation
• implemented @nebulon suggestion about using supervisord
• added /admin page for http mode to provide basic UI for managing content (no need of File Manager) to create and edit .gmi files and upload images

App is now a quick way to host a basic site (no fancy html/css/js blah blah) on both Gemini and HTTPS from one set of source content.

In-app content editing via /admin in http browser means quick and easy to update site content, even from your mobile phone 'on-the-go'.

REMEMBER to change the default user/password in /app/data/.env using File Manager and RESTART the app.
[it's in the app dashboard checklist].

[timconsidine]

I have uploaded a built docker image for those who want to test without building :

cloudron install —image tcmbp132021/cloudron-agate-plus:v6.36

Not sure it helps much because you still need the Cloudron CLI with your login to your Cloudron instance, and the CloudronManifest.json locally from the cloudron git repo.

[robi]

@timconsidine so far the easiest way we found was last year with @Kubernetes EasyInstall script, as you might recall.

[timconsidine]

@robi yep, I need to remind myself about it.
I have a vague distant feeling that it didn’t deal with the core issue that less techie users would still struggle with it. But hey, grey hair, don’t even recall my name some days, let me review it. Maybe the truth is I didn’t understand it at the time

[timconsidine]

@LoudLemur hey, did you see my post about CCAI ?
You can now use https://ccai.appx.uk to deploy custom apps to your own cloudron.
Anonymous - no login details saved.

Details : https://forum.cloudron.io/post/110907

[LoudLemur]

@timconsidine Hey, thanks! No, I missed that. I shall take a look.

WOW!

So all we need is to link a publicly accessible git and Docker image, and it does the magic for us?

Amazing! Surely, there must be more to it than that...?

[timconsidine]

@LoudLemur basically yes, simple as that, "magic" is behind the scenes

I'm cautious about the word "link", could be understood differently.

CCAI does this :

1. asks for :

• your cloudron domain e.g. my.cloudron-instance.tld (never stored)
• your user name (never stored)
• your password (never stored)
• your 2FA code (if you've enabled this, otherwise leave blank)
  If it logs in successfully,

2. asks for :

• git repo of the target custom app, e.g. https://git.cloudron.io/timconsidine/cloudron-agate-plus
• prebuilt docker image, e.g. tcmbp132021/cloudron-agate-plus:v6.36
• location where you want the custom app to deploy, e.g. your-gemini.your-domain.tld
• any port binding needed : optional in most cases, also optional for your first installation of Agate+, but subsequent instances need "GEMINI_PORT=1967" or higher number

So it's a bit more than just linking, but it's much easier than installing and using CLI, installing and using docker to build, installing and using a docker registry.

[timconsidine]

CCAI now has an "app picker" to populate necessary install data fields.

@LoudLemur Agate+ is one of the custom apps in the list

So is @DidierMalenfant Agate package, which is great for dedicated gemini site hosting.

[LoudLemur]

@timconsidine Exciting!
I like the idea of that App Picker!

I see it and tried, however it failed as another installation to the same cloudron was already in progress.

(I have been trying to package and deploy another custom application. I thought that process had ground to a halt, but the notification indicates that tcmbp thinks it is still trying...)

[timconsidine]

@LoudLemur errr
No idea, sorry
Have you tried doing one at a time ?

[robi]

@timconsidine I got the same message.

I tried to login, failed the first time, fixed typo from entered data, logged in.

Selected your agate+ package, then got the message it's already in progress.

Thoughts:
See if the error state is interfering between tries.
Make sure to clear it on every submission, not just starting over.
It's annoying that each field starts with capital letter on mobile.
Would help to have ports prefilled like in your app.

Update: tried again from scratch, no error modal, still got the failure.
Then switched to the other agate app and got this: Unsupported git hosting service.

Doesn't like self hosted domains other than github and cloudron. Lol

I'd upload a screenshot but can't seem to paste or upload from this mobile browser.

[robi]

Seems you have to start with the image first.

[timconsidine]

This post is deleted!

[timconsidine]

@robi thank you for the analysis

Yes, unsupported git hosting service is the critical error. I will remove the standard Agate package from the list until I can confirm Dider's git details.

@DidierMalenfant what is the git service behind "https://code.malenfant.net/didier/agate-app " ?
I can try to add support for it.
Also does it need port binding to be set ?

I will check my Agate+ settings again.