💾 Archived View for glv.one › docs captured on 2022-01-08 at 13:54:21. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

How to deploy an app

In your project create a Dockerfile that starts your server on port 1965. Here is an example project:

Wikipedia proxy

Register and create an app at glv.one.
Build a docker image that listens on port 1965. Image should be named deploy.glv.one/USERNAME/APP:VERSION where USERNAME is your glv.one username, APP is the app name, and VERSION is some unique version name, for example current date or git sha of current commit:

docker build --rm -t "deploy.glv.one/zuck/facebook:2004-02" .

(only needed once) In the terminal, run the following command, using your glv.one credentials:

docker login deploy.glv.one

Push the Docker image:

docker push deploy.glv.one/zuck/facebook:2004-02

What you get

Each app gets the following for FREE:

1 docker container, limited to 40mb of RAM and 0.2 CPU
1 mounted filesystem with daily backups (100MB max)
1 subdomain under glv.one (or use your own domain)
Admin interface at gemini://glv.one/apps with access to logs, rollbacks, etc

SSL Certificates

glv.one routing mesh doesn't perform SSL termination, so your app needs to come with its own certificate files. Any Gemini service/framework should support handling SSL termination.

If you are not using custom domains, you can choose to use Let's Encrypt certificates instead of generating and shipping your own. They are rotated periodically (so make sure to occastionally re-read them) and mounted under the following paths:

/meta/credentials/letsencrypt/current/fullchain.pem (certificate chain)
/meta/credentials/letsencrypt/current/privkey.pem (private key)

Volume (was Database)

Each app gets its own mounted volume. It is mounted under /mnt, or you can read MOUNT environment variable which is set to /mnt. This volume is backed up daily.

You can store a sqlite database file there.

Custom domains

If you own a domain (or subdomain) you want to use for your app, simply add a CNAME/ALIAS record with content "glv.one".

Additional functionality

If there is something special that you need in your app, feel free to reach out to admin at pitr.vern@gmail.com

Deleting account/app

Reach out to pitr.vern@gmail.com to delete your app or account. You keep ownership of your glv.one subdomain perpetually, which can be configured with any DNS record of your choosing.

🏠