Hello all,

There is now a docker image for Apple silicone/arm64 and Intel x86_64.  podman 
can be used to easily run these.

Apple silicone (MacOS)
1) brew install podman (brew can be obtained from: https://brew.sh)
2) podman machine init; podman machine start (init only needs to be run the 
first time - start only first time and if you reboot your machine)
3) podman run -d -p 8080:80 docker.io/fiddle55755/kea-quick-config

Intel (x86_64) (Linux - Debian 12)
1) sudo apt install podman
2) podman run -d -p 8080:80 docker.io/fiddle55755/kea-quick-config-x86_64

If you have an Intel mac, then install podman with brew and use the x86_64 image

Connect to it locally with your browser: http://localhost:8080

Thank you,

Darren Ankney

----- Original Message -----
From: "Darren Ankney" <dank...@isc.org>
To: "kea-users" <kea-users@lists.isc.org>
Sent: Wednesday, August 2, 2023 10:12:55 AM
Subject: New Project: Kea Quick Config

Hi all,

I have created a PHP/javascript based GUI Kea configuration maker which I've 
called "Kea Quick Config"!

What does it do? It allows you to use a series of web forms to set parameters.  
At the end of these "steps", a Kea configuration is generated.  You can copy 
this configuration and use it on your Kea machine.

What do I need to run it?  It can easily be run with only php installed 
locally.  For example, on MacOS: 
1. use Homebrew (https://brew.sh) to `brew install php` (as php is no longer 
included in the recent releases of MacOS).
2. clone the repository locally `git clone 
https://gitlab.isc.org/isc-projects/kea-quick-config.git`
3. cd into `cd kea-quick-config/src/public_html/`
4. then execute: `php -S localhost:8000` and the software will be available at: 
http://localhost:8000 

Installation should be even easier in Linux.  For example, Debian 11 steps:
1. Install php `sudo apt install php-cli` (the php package would install 
apache2 as well when all that is needed is php so we use php-cli here).
2. clone the repository `git clone 
https://gitlab.isc.org/isc-projects/kea-quick-config.git`
3. enter the directory `cd kea-quick-config/src/public_html/`
4. execute `php -S localhost:8000` and the software will be available at: 
http://localhost:8000

Installation under windows would be similar but you would first need to obtain 
git (https://git-scm.com) and php (https://www.php.net)

You CAN run this against an external IP address on your local machine to make 
it available to other machinery (e.g. `php -S 192.0.2.128:8000`), but this 
method using "php -S" is not meant for that type of use and may contain 
security bugs.  If you want to host an instance of the site for others to use, 
an installation of php using apache or similar web software should be 
considered.

Where do I find it? It can be found here: 
https://gitlab.isc.org/isc-projects/kea-quick-config Comments are welcome!  
Functionality is a bit basic at the moment.  Reservations and classes are 
completely absent as well as most options.  DHCPv6 is also not yet supported.

What about support? Please note that this is not an official ISC project and I 
am not a professional software developer.  This should be considered 
experimental and unsupported. That being said, do feel free to make a 
gitlab.isc.org account and open an issue in this project if you find a problem 
or missing feature.  There are some open issues there already so do have a look 
that it isn't already covered.  Feel free to indicate your interest with a 
comment or thumbs up if you find a previously opened issue.  Also, you can post 
to this kea-users list and I'll try to help you as best I can if you are having 
trouble.

Hopefully, this helps someone get started with Kea! I'll continue working on it 
if there is interest.

Thank you,

Darren Ankney
-- 
ISC funds the development of this software with paid support subscriptions. 
Contact us at https://www.isc.org/contact/ for more information.

To unsubscribe visit https://lists.isc.org/mailman/listinfo/kea-users.

Kea-users mailing list
Kea-users@lists.isc.org
https://lists.isc.org/mailman/listinfo/kea-users

Reply via email to