running.md

Running from sources

You can run Agama from its sources by cloning and configuring the project:

$ git clone https://github.com/openSUSE/agama
$ cd agama
$ ./setup.sh

Then point your browser to http://localhost:8080/, login with your root password and that's all.

The setup.sh script installs the required dependencies to build and run the project and it also configures the Agama services. It uses sudo to install packages and files to system locations. The script is well commented so we refer you to it instead of repeating its steps here.

Regarding the web user interface, alternatively you can run a development server which works as a proxy for Agama's server. See more details in the documentation.

To start or stop Agama D-Bus and web services at any time, use the agama and agama-web-server systemd services:

sudo systemctl start agama
sudo systemctl start agama-web-server

If something goes wrong, you can use journalctl to get Agama logs:

sudo journalctl -u agama
sudo journalctl -u agama-web-server

Another alternative is to run source checkout inside container so system is not affected by doing testing run beside real actions really done by installer. See more details in the documentation.