======Running muniad======

If you have followed the [[build:build|building instructions]] you should have an install directory containing all the necessary files for running the server.

Run the ''muniad'' service like so
<code>
install/bin/muniad --file <my database>.xml --port <my port> [--ssl]
</code>
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''
<code>
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
</code>

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:
<code>
install/bin/muniapwd <username>
</code>
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