# Install Admin Webclient

Installation guide of the Psono Admin Webclient

# Preamble

The admin webclient is a stateless website, allowing administrators to administrate Psono without the need to install anything (besides a browser). It can be served by any web server, we prefer Nginx, but any other webserver (Apache, IIS) is fine too. The admin web client is optional. As an alternative administrators can use the command line.

# Installation with Docker

The latest build of our Admin Web Client as a docker image can be found here: hub.docker.com/r/psono/psono-admin-client/ (opens new window) Follow belows instructions to bring it online.

Enable Management API

Verify that you have the following line in your server's' settings.yaml to enable the management API
```
MANAGEMENT_ENABLED: True
```
Don't forget to restart your server afterward.
Promote your admin user

As a next step you have to promote your user to become a superuser (at least for the first one). To do that, run the following command on one of your server instances:

If you installed the server with docker:
```
docker run --rm \
  -v /opt/docker/psono/settings.yaml:/root/.psono_server/settings.yaml \
  -ti psono/psono-combo:latest python3 ./psono/manage.py promoteuser username@example.com superuser
```
Run the docker image and expose the port
```
docker run --name psono-admin-client \
    -v /opt/docker/psono-client/config.json:/usr/share/nginx/html/portal/config.json \
    -d --restart=unless-stopped -p 10102:80 psono/psono-admin-client:latest
```
The config.json is the same one as you were using before with the normal client.

This will now start the Psono admin client on port 10102.

If you open now http://your-ip:10102 you should see a beautiful login screen. If you don't, please make sure no firewall is blocking your request.
Setup Reverse Proxy

To run the admin portal in production, a reverse proxy is needed, to handle the ssl offloading. Follow the guide to setup reverse proxy as a next step.

# Installation without Docker

The admin client is a pure html / js website, that can be hosted with any webserver and has zero dependencies.

Enable Management API

Verify that you have the following line in your server's' settings.yaml to enable the management API
```
MANAGEMENT_ENABLED: True
```
Don't forget to restart your server afterward.
Promote your admin user

As a next step you have to promote your user to become a superuser (at least for the first one). To do that, run the following command on one of your server instances:

If you installed the server with docker:
```
docker run --rm \
  -v /opt/docker/psono/settings.yaml:/root/.psono_server/settings.yaml \
  -ti psono/psono-combo:latest python3 ./psono/manage.py promoteuser username@example.com superuser
```
Download the admin artifact

Visit the following url and download the admin webclient:

get.psono.com/psono/psono-admin-client/latest/adminclient.zip (opens new window)
Install webclient

Create a folder called portal in your htdocs directory of your webserver and unpack the webclient into that folder.

TIP

Other paths will not work.
Update config.json

In the portal folder you will find a config.json. You can copy the config.json from your normal web client and replace the one in the portal folder

TIP

Other paths will not work.
Adjust permissions
```
chmod -R 644 htdocs/portal
```
Setup Reverse Proxy

To run the admin portal in production, you now have to configure your webserver with SSL. Follow the guide to setup reverse proxy as a next step.

← 3. Install Webclient (optional) 5. Install Reverse Proxy →