Running muniad

If you have followed the building instructions you should have an install directory containing all the necessary files for running the server.

Run the muniad service like so

install/bin/muniad --file <my database>.xml --port <my port> [--ssl]

If –file is omitted the database will be stored in /tmp/munia.xml which probably not what you want, but can nonetheless be useful for quick tests. If –ssl is added valid certificates must be put in install/share/munia/ws/libwebsockets-test-server.key.pem and install/share/munia/ws/libwebsockets-test-server.pem.

these files can be generated with openssl

openssl req -x509 -newkey rsa:4096 -keyout install/share/munia/ws/libwebsockets-test-server.key.pem -out install/share/munia/ws/libwebsockets-test-server.pem -days 365 -nodes

After this the server can be connected to using the https protocol instead of http.

A users file must be created in install/etc/munia/users. the content of this file is a line-based user/password-hash list. Each line can be created with the muniapwd tool:

install/bin/muniapwd <username>

Simply copy the first line of the output from the command to the users file.

Finally connect to whichever port was designated with firefox, for example: http://localhost:10000