d1daed14ddbca65a93bc93478fc1bdb9aa77a498
[vpp.git] / docs / gettingstarted / installing / ubuntu.rst
1 .. _ubuntu:
2
3 .. toctree::
4  
5 Ubuntu 16.04 - Setup the fd.io Repository
6 ==========================================
7
8 Choose one of the following releases to install.
9
10
11 Update the OS
12 -----------------------
13
14 It is a good idea to first update and upgrade the OS before starting; run the following command to update the OS:
15
16 .. code-block:: console
17
18     apt-get update
19
20
21 Point to the Repository
22 -----------------------------------
23
24 Create a file **/etc/apt/sources.list.d/99fd.io.list** with contents that point to
25 the version needed. The contents needed are shown below.
26
27 .. _install_vpp:
28
29 VPP latest Release
30 ^^^^^^^^^^^^^^^^^^^
31
32 Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents:
33
34 .. code-block:: console
35
36    deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io.ubuntu.xenial.main/ ./
37
38
39 VPP stable/1804 Branch
40 ^^^^^^^^^^^^^^^^^^^^^^^
41
42 Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents:
43
44 .. code-block:: console
45
46    deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io.stable.1804.ubuntu.xenial.main/ ./
47
48
49 VPP master Branch
50 ^^^^^^^^^^^^^^^^^^^^
51
52 Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents:
53
54 .. code-block:: console
55
56    deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io.master.ubuntu.xenial.main/ ./
57
58
59 Install the Mandatory Packages
60 ===============================
61
62 Install the mandatory packages by running the following commands:
63
64 .. code-block:: console
65
66   sudo apt-get update
67   sudo apt-get install vpp-lib vpp vpp-plugins
68
69
70 Install the Optional Packages
71 ==============================
72
73 Install the optional packages by running the following command:
74
75 .. code-block:: console
76
77   sudo apt-get install vpp-dbg vpp-dev vpp-api-java vpp-api-python vpp-api-lua
78
79
80 Uninstall the Packages
81 ======================
82
83 Uninstall the  packages by running the following command:
84
85 .. code-block:: console
86
87   sudo apt-get remove --purge vpp*