odoo-forge-bundle 0.1.0

package/payload/skills/odoo18-docs/references/docs/administration/on_premise/email_gateway.md

@@ -0,0 +1,51 @@
+---
+title: "Email gateway"
+source_url: "https://docs.odoo.sbggai.top/administration/on_premise/email_gateway.html"
+---
+
+=============
+# Email gateway
+
+The Odoo mail gateway allows you to inject directly all the received emails in Odoo.
+
+Its principle is straightforward: your SMTP server executes the "mailgate" script for every new
+incoming email.
+
+The script takes care of connecting to your Odoo database through XML-RPC, and send the emails via
+the `MailThread.message_process()` feature.
+
+## Prerequisites
+
+- Administrator access to the Odoo database.
+- Your own mail server such as Postfix or Exim.
+- Technical knowledge on how to configure an email server.
+
+## For Postfix
+
+In you alias config (:file:`/etc/aliases`):
+
+```text
+
+   email@address: "|/odoo-directory/addons/mail/static/scripts/odoo-mailgate.py -d <database-name> -u <userid> -p <password>"
+
+> **note**:
+>    Resources
+
+   - [Postfix ](http://www.postfix.org/documentation.html)
+   - [Postfix aliases ](http://www.postfix.org/aliases.5.html)
+   - [Postfix virtual ](http://www.postfix.org/virtual.8.html)
+
+## For Exim
+
+```text
+
+   *: |/odoo-directory/addons/mail/static/scripts/odoo-mailgate.py -d <database-name> -u <userid> -p <password>
+
+> **note**:
+>    Resources
+
+   - [Exim ](https://www.exim.org/docs.html)
+
+> **tip**:
+>    If you do not have access/manage your email server, use :ref:`incoming mail servers
+   <email-inbound-custom-domain-incoming-server>`.

package/payload/skills/odoo18-docs/references/docs/administration/on_premise/geo_ip.md

@@ -0,0 +1,65 @@
+---
+title: "Geo IP"
+source_url: "https://docs.odoo.sbggai.top/administration/on_premise/geo_ip.html"
+---
+
+======
+# Geo IP
+
+> **note**:
+>    This documentation only applies to On-premise databases.
+
+# Installation
+
+#. Download both the GeoLite2 City and Country
+   [databases ](https://dev.maxmind.com/geoip/geoip2/geolite2/). You should end up with two files
+   called :file:`GeoLite2-City.mmdb` and :file:`GeoLite2-Country.mmdb`.
+
+#. Move the files to the folder :file:`/usr/share/GeoIP/`.
+
+   ```bash
+
+       mv ~/Downloads/GeoLite2-City.mmdb /usr/share/GeoIP/
+       mv ~/Downloads/GeoLite2-Country.mmdb /usr/share/GeoIP/
+
+#. Restart the server
+
+> **note**:
+>    If you don't want to locate the geoip database in :file:`/usr/share/GeoIP/`, use the
+   :option:`--geoip-city-db <odoo-bin --geoip-city-db>` and
+   :option:`--geoip-country-db <odoo-bin --geoip-country-db>` options of the Odoo command line
+   interface. These options take the absolute path to the GeoIP database file and use it as the
+   GeoIP database. For example:
+
+   ```bash
+
+      ./odoo-bin --geoip-city-db= ~/Downloads/GeoLite2-City.mmdb
+
+   .. seealso::
+      - :doc:`CLI documentation </developer/reference/cli>`.
+
+# Test GeoIP geolocation in your Odoo website
+
+Edit a web page to include some geo-ip information such as the country name of the current
+request IP address. To do so:
+
+#. Go to your website. Open the web page that you want to test `GeoIP`.
+#. Choose :menuselection:`Customize --> HTML/CSS/JS Editor`.
+#. Add the following piece of XML in the page :
+
+   ```xml
+
+       <h1 class="text-center" t-esc="request.geoip.country.name or 'geoip failure'"/>
+
+#. Save and refresh the page.
+
+Geo-ip is working if you read your country name displayed in bold in the middle of the page.
+
+In case you read "**geoip failure**" instead then the geolocalization failed. The common causes are:
+
+#. The browsing IP address is the localhost (`127.0.0.1`) or a local area network one. If you
+   don't know, you can access your website using mobile data.
+#. You are using a reverse-proxy (apache, nginx) in front of Odoo but didn't start Odoo with the
+   proxy-mode enabled. See :option:`proxy mode <odoo-bin --proxy-mode>`.
+#. The GeoIP database is corrupt, missing or unaccessible. In such case a warning was logged in the
+   server logs.

package/payload/skills/odoo18-docs/references/docs/administration/on_premise/packages.md

@@ -0,0 +1,166 @@
+---
+title: "Packaged installers"
+source_url: "https://docs.odoo.sbggai.top/administration/on_premise/packages.html"
+---
+
+===================
+# Packaged installers
+
+Odoo provides packaged installers for Debian-based Linux distributions (Debian, Ubuntu, etc.),
+RPM-based Linux distributions (Fedora, CentOS, RHEL, etc.), and Windows for the Community and
+Enterprise editions.
+
+Official **Community** nightly packages with all relevant dependency requirements are available on
+the [nightly server ](https://nightly.odoo.com).
+
+> **note**:
+>    Nightly packages may be difficult to keep up to date.
+
+Official **Community** and **Enterprise** packages can be downloaded from the [Odoo download page
+](https://www.odoo.com/page/download).
+
+> **note**:
+>    It is required to be logged in as a paying on-premise customer or partner to download the
+   Enterprise packages.
+
+.. _install/packages/linux:
+
+# Linux
+
+## Prepare
+
+Odoo needs a [PostgreSQL ](https://www.postgresql.org/) server to run properly.
+
+.. tabs::
+
+   .. group-tab:: Debian/Ubuntu
+
+      The default configuration for the Odoo 'deb' package is to use the PostgreSQL server on the
+      same host as the Odoo instance. Execute the following command to install the PostgreSQL
+      server:
+
+      ```console
+
+         $ sudo apt install postgresql -y
+
+   .. group-tab:: Fedora
+
+      Make sure that the `sudo` command is available and well configured and, only then, execute the
+      following command to install the PostgreSQL server:
+
+      ```console
+
+         $ sudo dnf install -y postgresql-server
+         $ sudo postgresql-setup --initdb --unit postgresql
+         $ sudo systemctl enable postgresql
+         $ sudo systemctl start postgresql
+
+> **warning**:
+>    `wkhtmltopdf` is not installed through **pip** and must be installed manually in [version 0.12.6
+   ](https://github.com/wkhtmltopdf/packaging/releases/tag/0.12.6.1-3) for it to support headers
+   and footers. Check out the [wkhtmltopdf wiki ](https://github.com/odoo/odoo/wiki/Wkhtmltopdf)
+   for more details on the various versions.
+
+## Repository
+
+Odoo S.A. provides a repository that can be used to install the **Community** edition by executing
+the following commands:
+
+.. tabs::
+
+   .. group-tab:: Debian/Ubuntu
+
+      ```console
+
+         $ wget -q -O - https://nightly.odoo.com/odoo.key | sudo gpg --dearmor -o /usr/share/keyrings/odoo-archive-keyring.gpg
+         $ echo 'deb [signed-by=/usr/share/keyrings/odoo-archive-keyring.gpg] https://nightly.odoo.com/{CURRENT_MAJOR_BRANCH}/nightly/deb/ ./' | sudo tee /etc/apt/sources.list.d/odoo.list
+         $ sudo apt-get update && sudo apt-get install odoo
+
+      Use the usual `apt-get upgrade` command to keep the installation up-to-date.
+
+   .. group-tab:: Fedora
+
+      ```console
+
+         $ sudo dnf config-manager --add-repo=https://nightly.odoo.com/{CURRENT_MAJOR_BRANCH}/nightly/rpm/odoo.repo
+         $ sudo dnf install -y odoo
+         $ sudo systemctl enable odoo
+         $ sudo systemctl start odoo
+
+> **note**:
+>    Currently, there is no nightly repository for the Enterprise edition.
+
+## Distribution package
+
+Instead of using the repository, packages for both the **Community** and **Enterprise** editions can
+be downloaded from the [Odoo download page ](https://www.odoo.com/page/download).
+
+.. tabs::
+
+   .. group-tab:: Debian/Ubuntu
+
+      > **note**:
+>          Odoo {CURRENT_MAJOR_VERSION} 'deb' package currently supports [Debian Buster
+         ](https://www.debian.org/releases/buster/) and [Ubuntu 18.04
+         ](https://releases.ubuntu.com/18.04) or above.
+
+      Once downloaded, execute the following commands **as root** to install Odoo as a service,
+      create the necessary PostgreSQL user, and automatically start the server:
+
+      ```console
+
+         # dpkg -i <path_to_installation_package> # this probably fails with missing dependencies
+         # apt-get install -f # should install the missing dependencies
+         # dpkg -i <path_to_installation_package>
+
+      > **warning**:
+>          - The `python3-xlwt` Debian package, needed to export into the XLS format, does not exist
+           in Debian Buster nor Ubuntu 18.04. If needed, install it manually with the following:
+
+           ```console
+
+              $ sudo pip3 install xlwt
+
+         - The `num2words` Python package - needed to render textual amounts - does not exist in
+           Debian Buster nor Ubuntu 18.04, which could cause problems with the `l10n_mx_edi` module.
+           If needed, install it manually with the following:
+
+           ```console
+
+              $ sudo pip3 install num2words
+
+   .. group-tab:: Fedora
+
+      > **note**:
+>          Odoo {CURRENT_MAJOR_VERSION} 'rpm' package supports Fedora 38.
+
+      Once downloaded, the package can be installed using the 'dnf' package manager:
+
+      ```console
+
+         $ sudo dnf localinstall odoo_{CURRENT_MAJOR_BRANCH}.latest.noarch.rpm
+         $ sudo systemctl enable odoo
+         $ sudo systemctl start odoo
+
+.. _install/packages/windows:
+
+# Windows
+
+   > **warning**:
+>       Windows packaging is offered for the convenience of testing or running single-user local
+      instances but production deployment is discouraged due to a number of limitations and risks
+      associated with deploying Odoo on a Windows platform.
+
+#. Download the installer from the [nightly server ](https://nightly.odoo.com) (Community only) or
+   the Windows installer from the [Odoo download page ](https://www.odoo.com/page/download) (any
+   edition.
+#. Execute the downloaded file.
+
+   > **warning**:
+>       On Windows 8 and later, a warning titled *Windows protected your PC* may be displayed. Click
+      **More Info** and then **Run anyway** to proceed.
+
+#. Accept the [UAC ](https://en.wikipedia.org/wiki/User_Account_Control) prompt.
+#. Go through the installation steps.
+
+Odoo launches automatically at the end of the installation.