Debian

Device Requirements (Debian)

GalixiHub does not use any compiled binaries, and as such, is able to run on any device that is able to run a Debian-based Linux system. The CPU does not matter either; x86 or ARM, 32-bit or 64-bit will be able to run GalixiHub. External package dependencies include openjdk-11-jre-headless and mariadb-server. Those two packages must be available on the system in order to run GalixiHub.

Download GalixiHub (Debian)

The Debian packages for GalixiHub is available via APT once the APT repository is added as part of the APT management to the device that will run GalixiHub. It is free to use, and does not require a subscription or payment of any kind. To add the GalixiHub APT repository, do the following:

1. Add the GalixiHub repository key to the local machine keyring:

curl -fsSL https://galixsys-networks.com/debian/galixihub-archive-keyring.gpg | sudo gpg --dearmor -o /usr/share/keyrings/galixihub-archive-keyring.gpg

2. Add the GalixiHub repository:

echo "deb [signed-by=/usr/share/keyrings/galixihub-archive-keyring.gpg] https://galixsys-networks.com/debian stable main" | sudo tee /etc/apt/sources.list.d/galixihub.list

Install GalixiHub (Debian)

Installation of GalixiHub is no different than any other Debian package install. During installation, there are a series of prompts that will appear whose properties can configuration is explained below.

Update APT packages and install:

sudo apt update
sudo apt install galixihub

Follow the on-screen prompts:

1. Accept License. Delete “NO” and type in “YES” to accept the license for GalixiHub. The license can be found at usr/share/doc/galixihub/LICENSE.gz and will need to be unzipped to read.

2. World Name. Enter the name of the world here. Note that once set, the world name CANNOT be changed.

3. Hostname or IP Address. Enter either the public IP address, or (preferred) a domain name here. It is strongly recommended to get a domain name for the world as if the ISP changes the public IP address, the world will be un-accessible.

4. Port Number. The network port that the world uses. Note that the ports used by GalixiHub will be the number entered here plus the next one (so if 50500 is used, GalixiHub will use both 50500 and 50501). These ports must be forwarded via any gateway used on a physical network.

5. Owner Code. The initial code used to connect to this world as the Owner. Once the world is setup, the world must be connected to by the owner’s device running GalixiCom, and set as an Owner in order to manage this site. No local management is available (only owner reset; see below). Once connected to, it is strongly recommended to change the owner code via GalixiCom, and to disable the ability for any other device to join as an Owner.

Remote Management (Debian)

In order to manage the world properties created by GalixiHub, the Owner of the world must connect to that world (ideally as the first user to join the world) via the GalixiCom app (which must be subscribed to, see the details for Android Subscriptions or iOS Subscriptions) as an Owner. This is critical and done via entering the owner code (as setup in step 5 above) in the “Access Code” field of the Android Join World or iOS Join World screen in GalixiCom.

Once connected as an Owner, additional menus appear on the Android Existing Chats or iOS Existing Chats screen to aid in the management of the world (such as changing the world avatar icon or image, descriptions of the world, etc.), with additional types of messaging options available (such as sending Announcements (q.v.)). Options to manage the world include Android World Information and iOS World Information, Android Modify World and iOS Modify World, Android Member Management and iOS Member Management, and Android Modify Member and iOS Modify Member.

Reset Owner (Debian)

All remote operation functions are expected to be done by the owner’s device through GalixiCom, connected to the world as an Owner. The only capability the Debian version of GalixiHub has is to reset the Owner state via the following commands below:

Owner Status. Displays the Owner status state, and code to join

sudo galixihub-admin owner-status

Enable Owner. Enables a device to join as an Owner

sudo galixihub-admin owner-enable

Disable Owner. Does not allow devices to join as an Owner (only as a Member (q.v.))

sudo galixihub-admin owner-disable

Reset Owner. Enables a device to join as an Owner, with the code being what is passed on the command line (numeric between 6-12 digits).

sudo galixihub-admin reset-owner <code>

Filesystem Layout (Debian)

/
├── opt/
│   └── galixihub/
│       └── galixihub.jar
├── var/
│   ├── lib/
│   │   └── galixihub/
│   │       ├── AvatarPhotos/
│   │       ├── Images/
│   │       └── Messages/
│   └── log/
│       └── galixihub/
├── etc/
│   └── galixihub/
│       └── galixihub.env
└── usr/
    ├── sbin/
    │   └── galixihub-admin
    └── share/
        └── doc/
            └── galixihub/
                └── LICENSE.gz

Filesystem Details (Debian)

/opt/galixihub/: Application directory containing galixihub.jar.
/var/lib/galixihub/AvatarPhotos/: User avatar storage.
/var/lib/galixihub/Images/: Uploaded images.
/var/lib/galixihub/Messages/: Stored messages.
/var/log/galixihub/: Application log files, including error logs.
/etc/galixihub/: Configuration directory containing galixihub.env.
/usr/share/doc/galixihub/LICENSE: License agreement.
/usr/sbin/galixihub-admin: Administrative CLI utility.

Remove GalixiHub (Debian)

To remove GalixiHub, run the following:

sudo apt purge galixihub