/netplan

Declarative network configuration for various backends

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Netplan - Declarative network configuration for various backends

Build+ABI Test+Coverage CI

Website

http://netplan.io

Documentation

An overview of the architecture can be found at netplan.io/design

Find the full documentation for Netplan on "Read the Docs".

To contribute documentation, these steps should get you started:

  1. Fork and clone the repo:

    git clone git@github.com:your_user_name/netplan.git
    
  2. Create a new branch:

    git checkout -b <your_branch_name>
    
  3. Navigate to the doc/ directory and make your contribution:

    cd doc
    
  4. View your documentation in the browser by running the make command from within the doc/ directory:

    make run
    
  5. Test your contribution to ensure good quality.

  6. Push your contribution to GitHub and create a pull request.

If you face issues, refer to our comprehensive contribution guide.

Build using Meson

Steps to build Netplan using the Meson build system inside the build/ directory:

  • meson setup build --prefix=/usr [-Db_coverage=true]
  • meson compile -C build
  • meson test -C build --verbose [TEST_NAME]
  • meson install -C build --destdir ../tmproot

Bug reports

Please file bug reports in Launchpad.

Contact us

Please join us on IRC in #netplan at Libera.Chat.

Our mailing list is here.

Email the list at netplan-developers@lists.launchpad.net.