summaryrefslogtreecommitdiffstats
path: root/README.appimage.rst
diff options
context:
space:
mode:
authorMark Wong <mark@2ndQuadrant.com>2020-04-05 17:38:15 -0700
committerMark Wong <mark@2ndQuadrant.com>2020-04-06 11:11:32 -0700
commitbb43f85bedde266746e1b4ba23f2af201631d25c (patch)
tree8db17499c2944749c188a29a571e355953c0fff7 /README.appimage.rst
parente49e905909363990fe49414ed687d21aa5c3901c (diff)
Convert various text files to rst
Diffstat (limited to 'README.appimage.rst')
-rw-r--r--README.appimage.rst31
1 files changed, 31 insertions, 0 deletions
diff --git a/README.appimage.rst b/README.appimage.rst
new file mode 100644
index 0000000..9da3ce1
--- /dev/null
+++ b/README.appimage.rst
@@ -0,0 +1,31 @@
+AppImages are only for Linux based systems:
+
+ https://appimage.org/
+
+The AppImageKit AppImage can be downloaded from:
+
+ https://github.com/AppImage/AppImageKit/releases
+
+It is recommended to build AppImages on older distributions:
+
+ https://docs.appimage.org/introduction/concepts.html#build-on-old-systems-run-on-newer-systems
+
+At the time of this document, CentOS 6 is the one of the oldest supported Linux
+distributions with the oldest libc version.
+
+Use a custom configured PostgreSQL build with minimal options enabled to reduce
+library dependency support. Part of this reason is to make it easier to
+include libraries with compatible licences. Part of the reason is to be able
+to build libpq with minimal development dependencies for PostgreSQL, since the
+purpose is just to build a pg_top AppImage. At least version PostgreSQL 10
+should be used so that PGHOST can be defined in the AppRun script to search
+multiple potential unixsock directories if no PGHOST is defined in the user's
+environment.
+
+At the time of this document, PostgreSQL 10 was configured with the following
+options::
+
+ ./configure --without-ldap --without-readline --without-zlib --without-gssapi
+
+Don't forget you may have to set both PATH and LD_LIBRARY_PATH appropriately
+depending on where the custom build of PostgreSQL is installed.