2024-09-27 15:37:49 -07:00
|
|
|
.. _getting_started:
|
|
|
|
|
|
2024-09-20 17:08:42 -07:00
|
|
|
Getting Started
|
|
|
|
|
================
|
|
|
|
|
|
2024-09-25 23:43:34 -07:00
|
|
|
.. sidebar:: Pre-requisites
|
2024-09-30 14:54:01 -07:00
|
|
|
|
|
|
|
|
In order for you to get started, please make sure that `Docker <https://www.docker.com/get-started>`_
|
2024-09-25 23:43:34 -07:00
|
|
|
and `Python <https://www.python.org/downloads/>`_ are installed locally.
|
|
|
|
|
|
2024-09-30 14:54:01 -07:00
|
|
|
As the examples use the pre-built `Arch Docker images <https://hub.docker.com/r/katanemo/arch>`_,
|
2024-09-25 23:43:34 -07:00
|
|
|
they should work on the following architectures:
|
|
|
|
|
|
|
|
|
|
- x86_64
|
|
|
|
|
- ARM 64
|
|
|
|
|
|
|
|
|
|
|
2024-09-27 15:37:49 -07:00
|
|
|
This section gets you started with a very simple configuration and provides some example configurations.
|
|
|
|
|
|
|
|
|
|
|
2024-09-24 13:54:17 -07:00
|
|
|
The fastest way to get started using Arch is installing `pre-built binaries <https://hub.docker.com/r/katanemo/arch>`_.
|
|
|
|
|
You can also build it from source.
|
2024-09-25 23:43:34 -07:00
|
|
|
|
2024-09-27 15:37:49 -07:00
|
|
|
Step 1: Install the Arch CLI
|
|
|
|
|
----------------------------
|
2024-09-30 14:54:01 -07:00
|
|
|
Arch's CLI allows you to manage and interact with the Arch gateway efficiently. To install the CLI, simply
|
2024-09-27 15:37:49 -07:00
|
|
|
run the following command:
|
|
|
|
|
|
2024-09-30 14:54:01 -07:00
|
|
|
.. code-block:: bash
|
|
|
|
|
|
2024-09-27 15:37:49 -07:00
|
|
|
pip install archgw
|
|
|
|
|
|
|
|
|
|
This will install the archgw command-line tool globally on your system.
|
|
|
|
|
|
|
|
|
|
Step 2: Start Arch Gateway
|
|
|
|
|
--------------------------
|
|
|
|
|
|
2024-09-30 14:54:01 -07:00
|
|
|
.. code-block:: bash
|
|
|
|
|
|
2024-09-27 15:37:49 -07:00
|
|
|
archgw up --quick-start
|
|
|
|
|
|
|
|
|
|
Configuration
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
Today, only support a static bootstrap configuration file for simplicity today:
|
|
|
|
|
|
|
|
|
|
.. literalinclude:: /_config/getting-started.yml
|
|
|
|
|
:language: yaml
|