Installation (Composer)

Note: This is an alternative way to install and update Poweradmin using Composer.

Prerequisites

• PHP 8.1 or higher
• Composer installed on your system
• Required PHP extensions: pdo, pdo_mysql/pdo_pgsql/pdo_sqlite

See System Requirements for detailed requirements.

Installing Poweradmin

To install the latest stable version of Poweradmin, you can use the following Composer command:

composer create-project --no-dev poweradmin/poweradmin

This command will create a poweradmin folder in the current directory, download, and set up Poweradmin without development dependencies. After running the Composer command, you need to create a simple configuration file at inc/config.inc.php with basic database settings.

Directory Structure

After installation, you should have the following structure:

poweradmin/
├── ...
├── inc/
│ └── config.inc.php
├── lib/
├── ...
├── vendor/
├── composer.json
└── composer.lock

Basic Configuration

Here is an example of what the inc/config.inc.php file should look like:

<?php
// Database settings
$db_host = 'localhost';
$db_name = 'your_db_name';
$db_user = 'your_db_user';
$db_pass = 'your_db_password';
$db_type = 'mysql'; // or 'pgsql'

See Basic Configuration for all available options.

SQLite Database Settings

If you are using SQLite, uncomment the following lines in the inc/config.inc.php file:

// Database settings for SQLite
$db_type = 'sqlite';
$db_file = '/path/to/your/sqlite.db';

Important: Ensure proper file permissions and directory location for the SQLite database file.

Updating Poweradmin

If you installed Poweradmin using composer create-project --no-dev poweradmin/poweradmin, here's how to update it later:

1. Navigate to your project directory in the terminal:

cd /path/to/poweradmin

1. If you want to update to a newer version of the Poweradmin package itself, you'll need to modify the version constraint in your composer.json file, then run the update command. For specifically updating just the Poweradmin package:

composer update poweradmin/poweradmin --no-dev

If the project has specific update instructions, check the documentation or GitHub repository for any additional steps that might be required (such as database migrations).

The --no-dev flag ensures that development dependencies aren't installed, keeping your production environment clean, just like when you initially installed the project.

Post-Installation Steps

1. Set up the database schema (see MySQL/MariaDB, PostgreSQL, or SQLite setup)
2. Configure web server permissions
3. Set up initial admin user
4. Configure PowerDNS connection

Troubleshooting

For common installation issues and solutions, see Common Issues.