Applications

From pronounmail wiki
Revision as of 23:45, 24 October 2024 by Leah (talk | contribs) (→‎Webserver)
Jump to navigation Jump to search

Applications are like web pages but more complicated. If you would like to run an application please ask first :3

What is an Application

This guy

Anything that need a daemon basically.

Guidelines

Systemd

Users can freely set up systemd units to run their daemons. Put your service files and such in ~/.config/systemd/user/ and pass --user when using systemctl.

For example:

$ nano ~/.config/systemd/user/my_service.service
# (inside the file)

[Unit]
Description=My cool application
After=network.target
Before=nextcloud-web.service

[Service]
ExecStart=/home/leah/application/start.sh
Type=notify
Restart=on-failure

[Install]
WantedBy=default.target
RequiredBy=network.target

# (save + exit)

$ systemctl --user enable --now my_service.service

More documentation is available

Networking

Please please please have your application listen over a Unix Domain Socket (where the socket is a filesystem node) over a Internet domain socket (where the socket is an IP address and a port number).

Database(s)

We have a PosgreSQL instance that you may plug your things into. Ping leah and she'll set up a database and account for you.

You can also use SQLite or whatever

Webserver

Your application needs to be reverse-proxied through the webserver in order to appear on pronounmail.com.

All webserver configuration must currently pass through leah. Please ask her nicely if you need things to be changèd.

Alternatively

If you're not expecting too much traffic, it might be wise to write your thing with CGI. We also have PHP, which works quite well.