====== Installing Accel-ppp on Ubuntu 22.04 ======
===== Introduction =====
  * The Accel-ppp project has extensive documentation and forums where you can gather information.
  * Their installation instructions were used as a reference for the instructions on this page.
  * https://docs.accel-ppp.org/installation/ubuntu.html

===== Installation instructions =====
  * Install the following packages:
<code>
sudo apt-get install -y build-essential cmake gcc linux-headers-`uname -r` git libpcre3-dev libssl-dev liblua5.1-0-dev
</code>
  * Checkout the latest git source code:
<code>
sudo git clone https://github.com/accel-ppp/accel-ppp.git /opt/accel-ppp-code
</code>
  * Create a directory for the build source code and change to this directory.
<code>
sudo mkdir /opt/accel-ppp-code/build
cd /opt/accel-ppp-code/build/
</code>
  * Generate the Makefile:
<code>
sudo cmake -DBUILD_IPOE_DRIVER=TRUE -DBUILD_VLAN_MON_DRIVER=TRUE -DCMAKE_INSTALL_PREFIX=/usr -DKDIR=/usr/src/linux-headers-`uname -r` -DLUA=TRUE -DCPACK_TYPE=Ubuntu22 ..
</code>

<alert type="info">
Remember the **..** at the end of the statement. It specifies the path to the source code of accel-ppp. **Do not delete this!** Alternatively you can replace it with the full path to the accel-ppp source code like ///opt/accel-ppp-code///
</alert>

  * Compile
<code>
sudo make
</code>
  * Create a DEB package
<code>
sudo cpack -G DEB
</code>
  * Install the package
<code>
sudo dpkg -i accel-ppp.deb
</code>
  * If the installation went well, you can use the reference configuration file and make it active
<code>
sudo mv /etc/accel-ppp.conf.dist /etc/accel-ppp.conf
</code>
  * We will cover the configuration of a simple PPPoE server on a separate wiki page.
  * See if it starts. It should start with the default configuration file
<code>
sudo systemctl start accel-ppp
sudo systemctl status accel-ppp
</code>
  * Make sure that the service is activated for startup.
<code>
sudo systemctl enable accel-ppp
</code>
  * If you want to start the service manually
<code>
sudo accel-pppd -d -c /etc/accel-ppp.conf -p /var/run/accel-ppp.pid
</code>
  * Next, let us take a look at some of the important files that were installed with the **accel-ppp.deb** package
===== Important files =====
  * To determine the files installed with the .deb package, we output the following:
<code>
sudo dpkg -L accel-ppp
/etc
/etc/accel-ppp.conf.dist
/etc/default
/etc/default/accel-ppp
/etc/init.d
/etc/init.d/accel-ppp
/lib
/lib/modules
/lib/modules/5.15.0-84-generic
/lib/modules/5.15.0-84-generic/extra
/lib/modules/5.15.0-84-generic/extra/ipoe.ko
/lib/modules/5.15.0-84-generic/extra/vlan_mon.ko
/usr
/usr/bin
/usr/bin/accel-cmd
/usr/lib
/usr/lib/systemd
/usr/lib/systemd/system
/usr/lib/systemd/system/accel-ppp.service
/usr/lib64
/usr/lib64/accel-ppp
/usr/lib64/accel-ppp/libauth_chap_md5.so
/usr/lib64/accel-ppp/libauth_mschap_v1.so
/usr/lib64/accel-ppp/libauth_mschap_v2.so
/usr/lib64/accel-ppp/libauth_pap.so
/usr/lib64/accel-ppp/libchap-secrets.so
/usr/lib64/accel-ppp/libconnlimit.so
/usr/lib64/accel-ppp/libipoe.so
/usr/lib64/accel-ppp/libippool.so
/usr/lib64/accel-ppp/libipv6_dhcp.so
/usr/lib64/accel-ppp/libipv6_nd.so
/usr/lib64/accel-ppp/libipv6pool.so
/usr/lib64/accel-ppp/libl2tp.so
/usr/lib64/accel-ppp/liblog_file.so
/usr/lib64/accel-ppp/liblog_syslog.so
/usr/lib64/accel-ppp/liblog_tcp.so
/usr/lib64/accel-ppp/liblogwtmp.so
/usr/lib64/accel-ppp/libluasupp.so
/usr/lib64/accel-ppp/libpppd_compat.so
/usr/lib64/accel-ppp/libpppoe.so
/usr/lib64/accel-ppp/libpptp.so
/usr/lib64/accel-ppp/libradius.so
/usr/lib64/accel-ppp/libshaper.so
/usr/lib64/accel-ppp/libsigchld.so
/usr/lib64/accel-ppp/libsstp.so
/usr/lib64/accel-ppp/libtriton.so
/usr/lib64/accel-ppp/libvlan-mon.so
/usr/sbin
/usr/sbin/accel-pppd
/usr/share
/usr/share/accel-ppp
/usr/share/accel-ppp/l2tp
/usr/share/accel-ppp/l2tp/dictionary
/usr/share/accel-ppp/l2tp/dictionary.rfc2661
/usr/share/accel-ppp/l2tp/dictionary.rfc3931
/usr/share/accel-ppp/radius
/usr/share/accel-ppp/radius/dictionary
/usr/share/accel-ppp/radius/dictionary.accel
/usr/share/accel-ppp/radius/dictionary.alcatel
/usr/share/accel-ppp/radius/dictionary.cisco
/usr/share/accel-ppp/radius/dictionary.dhcp
/usr/share/accel-ppp/radius/dictionary.microsoft
/usr/share/accel-ppp/radius/dictionary.mikrotik
/usr/share/accel-ppp/radius/dictionary.rfc2865
/usr/share/accel-ppp/radius/dictionary.rfc2866
/usr/share/accel-ppp/radius/dictionary.rfc2867
/usr/share/accel-ppp/radius/dictionary.rfc2868
/usr/share/accel-ppp/radius/dictionary.rfc2869
/usr/share/accel-ppp/radius/dictionary.rfc3162
/usr/share/accel-ppp/radius/dictionary.rfc3576
/usr/share/accel-ppp/radius/dictionary.rfc3580
/usr/share/accel-ppp/radius/dictionary.rfc4072
/usr/share/accel-ppp/radius/dictionary.rfc4372
/usr/share/accel-ppp/radius/dictionary.rfc4675
/usr/share/accel-ppp/radius/dictionary.rfc4679
/usr/share/accel-ppp/radius/dictionary.rfc4818
/usr/share/accel-ppp/radius/dictionary.rfc4849
/usr/share/accel-ppp/radius/dictionary.rfc5176
/usr/share/accel-ppp/radius/dictionary.rfc6911
/usr/share/man
/usr/share/man/man1
/usr/share/man/man1/accel-cmd.1
/usr/share/man/man5
/usr/share/man/man5/accel-ppp.conf.5
/var
/var/log
/var/log/accel-ppp
</code>

===== Next Up =====
  * Be sure to visit the other Wiki Pages that gives you detail on how to configure Accel-ppp.