ActiveDebianSync: Setup the web console.

You can install a simple web console to view logs and status of the repository

Back to the ActiveDebianSync main section

ActiveDebianSync includes a built-in web console for managing and monitoring your Debian repository through a browser interface.
This document covers installation, configuration, usage.

The web console provides a graphical interface for monitoring synchronization status in real-time, viewing server statistics and client connections, uploading custom .deb packages, managing users and access control, configuring system settings and viewing event logs and package updates

Enabling the Web Console

Add the following to your /etc/ActiveDebianSync/config.json:

{
  "web_console_enabled": true,
  "web_console_port": 8090,
  "web_console_listen_addr": "127.0.0.1",
  "web_console_https_enabled": false,
  "web_console_session_timeout": 60
}

Configuration Options

Option	Type	Default	Description
`web_console_enabled`	bool	`false`	Enable/disable the web console
`web_console_port`	int	`8090`	Port to listen on
`web_console_listen_addr`	string	`127.0.0.1`	Listen address (`127.0.0.1` for local only, `0.0.0.0` for all interfaces)
`web_console_https_enabled`	bool	`false`	Enable HTTPS
`web_console_tls_cert_file`	string	`/etc/ActiveDebianSync/console.crt`	TLS certificate path
`web_console_tls_key_file`	string	`/etc/ActiveDebianSync/console.key`	TLS private key path
`web_console_session_secret`	string	(auto-generated)	Secret for session encryption
`web_console_session_timeout`	int	`60`	Session timeout in minutes

Install assets directory

Create an assets directory where you place the configuration file ( eg: /etc/ActiveDebianSync/assets
Download the assets content from the github repository “https://github.com/dtouzeau/activedebiansync/tree/master/assets”
Put all files inside the /etc/ActiveDebianSync/assets

Enabling HTTPS

For production use, HTTPS is strongly recommended:

{
  "web_console_enabled": true,
  "web_console_port": 8090,
  "web_console_listen_addr": "0.0.0.0",
  "web_console_https_enabled": true,
  "web_console_tls_cert_file": "/etc/ActiveDebianSync/console.crt",
  "web_console_tls_key_file": "/etc/ActiveDebianSync/console.key"
}

Generate a self-signed certificate for testing:

openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
  -keyout /etc/ActiveDebianSync/console.key \
  -out /etc/ActiveDebianSync/console.crt \
  -subj "/CN=activedebiansync.local"

For production, use certificates from Let's Encrypt or your organization's CA.

Create Initial Admin User

On first startup, no users exist. Create an admin user using the command line:

./activedebiansync --create-admin

Or via the REST API:

curl -X POST http://localhost:9090/api/users/create \
-H "Content-Type: application/json" \
-d '{"username":"admin","password":"secure-password","role":"admin"}'