docs: add 1810, including package cloud
[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 FD.io VPP is installed using Package Cloud. For a complete set of
9 instructuctions on how to install VPP with package cloud please refer
10 to `Package Cloud <https://packagecloud.io/fdio/release>`_
11
12 Choose one of the following releases to install. 
13
14 Update the OS
15 -----------------------
16
17 It is a good idea to first update and upgrade the OS before starting; run the
18 following command to update the OS:
19
20 .. code-block:: console
21
22     apt-get update
23
24
25 Point to the Repository
26 -----------------------------------
27
28 Create a file **/etc/apt/sources.list.d/99fd.io.list** with contents that point to
29 the version needed. The contents needed are shown below.
30
31 .. _install_vpp:
32
33 VPP latest Release
34 ^^^^^^^^^^^^^^^^^^^
35
36 Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents:
37
38 .. code-block:: console
39
40    deb [trusted=yes] https://packagecloud.io/fdio/release/ubuntu xenial main ./
41
42 Get the key:
43
44 .. code-block:: console
45
46   curl -L https://packagecloud.io/fdio/release/gpgkey | sudo apt-key add -
47
48 VPP 1810 Branch
49 ^^^^^^^^^^^^^^^^
50
51 Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents:
52
53 .. code-block:: console
54
55    deb [trusted=yes] https://packagecloud.io/fdio/1810/ubuntu xenial main ./
56
57 Get the key:
58
59 .. code-block:: console
60
61   curl -L https://packagecloud.io/fdio/1810/gpgkey | sudo apt-key add -
62
63
64 VPP master Branch
65 ^^^^^^^^^^^^^^^^^^^^
66
67 Create the file **/etc/apt/sources.list.d/99fd.io.list** that contain the following contents:
68
69 .. code-block:: console
70
71    deb [trusted=yes] https://packagecloud.io/fdio/master/ubuntu xenial main ./
72
73 Get the key:
74
75 .. code-block:: console
76
77   curl -L https://packagecloud.io/fdio/master/gpgkey | sudo apt-key add -
78
79
80 Install the Mandatory Packages
81 ===============================
82
83 Install the mandatory packages by running the following commands:
84
85 .. code-block:: console
86
87   sudo apt-get update
88   sudo apt-get install vpp-lib vpp vpp-plugins
89
90   
91 Install the Optional Packages
92 ==============================
93
94 Install the optional packages by running the following command:
95
96 .. code-block:: console
97
98   sudo apt-get install vpp-dbg vpp-dev vpp-api-java vpp-api-python vpp-api-lua
99
100
101 Uninstall the Packages
102 ======================
103
104 Uninstall the  packages by running the following command:
105
106 .. code-block:: console
107
108   sudo apt-get remove --purge vpp*