Applications: Difference between revisions

From pronounmail wiki
Jump to navigation Jump to search
No edit summary
 
(One intermediate revision by the same user not shown)
Line 22: Line 22:
  Description=My cool application
  Description=My cool application
  After=network.target
  After=network.target
Before=nextcloud-web.service
   
   
  [Service]
  [Service]
Line 49: Line 48:
Your application needs to be reverse-proxied through the webserver in order to appear on pronounmail.com.
Your application needs to be reverse-proxied through the webserver in order to appear on pronounmail.com.


All webserver configuration must currently pass through [[User:leah|leah]]. Please ask her nicely if you need things to be changéd.
All webserver configuration must currently pass through [[User:leah|leah]]. Please ask her nicely if you need things to be changèd.


== Alternatively ==
== 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.
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.

Latest revision as of 23:46, 24 October 2024

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

[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.