This Python web application allows MacPorts Developers to set an SMTP password for the MacPorts mailserver.
It is written in Python >= 3.8, and uses the Flask web application framework.
To install a development copy of this, you will need poetry, which
can be installed from MacPorts. Once you have poetry installed,
run poetry install to download and install the required dependencies. Poetry
will by default do that in a virtualenv. Note that you may want to run poetry config virtualenvs.in-project true to have the virtualenv created in the
project directory, rather than in some cache directory.
Start the server using
FLASK_APP=smtpselfservice FLASK_DEBUG=1 poetry run flask run
The application will then be running on localhost:5000. Note that for the
application to work correctly, you will have to send a valid GitHub OAuth2
token with the email:read scope in the X-Forwarded-Access-Token HTTP
header. This can, for example, be achieved by forwarding your local
installation to the remote server running smtpselfservice.macports.org using
ssh -v -N -R:$remoteport:127.0.0.1:$localport $server
You can set the database URI using the DATABASE_URI environment variable. See
the documentation on libpq connection strings for the format.