fusionauth / fusionauth-install Goto Github PK

View Code? Open in Web Editor NEW

68.0 14.0 10.0 68 KB

FusionAuth simple install scripts. Copy, Paste, Code.

Home Page: https://fusionauth.io

Shell 40.09% PowerShell 59.91%

bash powershell fusionauth install-script

fusionauth-install's Introduction

FusionAuth FastPath(tm) Install

Software should be easy to install, so we've provided you with some shortcuts to getting up and running.

Package Installs

macOS and Linux

Note: Elasticsearch is not installed by default. To install Elasticsearch supply -s to the installer script.

Options:

s - Install Elasticsearch. Elasticsearch provides enhanced search capability in FusionAuth.
h - Show the help text.

Environment variables:

TARGET_DIR - The location to install the zip. Defaults value is $PWD/fusionauth. This value is ignored when installing Debian or RPM packages.
VERSION - The version to install. Defaults to the latest stable version.

Examples

Download and install FusionAuth without Elasticsearch

sh -c "curl -fsSL https://raw.githubusercontent.com/FusionAuth/fusionauth-install/master/install.sh | sh"

Download and install with Elasticsearch

sh -c "curl -fsSL https://raw.githubusercontent.com/FusionAuth/fusionauth-install/master/install.sh | sh -s - -s"

Windows

Download and install FusionAuth without Elasticsearch

. { iwr -useb https://raw.githubusercontent.com/FusionAuth/fusionauth-install/master/install.ps1 } | iex; install
REM Optionally register the service with the following commands
cd fusionauth\fusionauth-app\bin
FusionAuthApp.exe /install

Download and install FusionAuth with Elasticsearch

. { iwr -useb https://raw.githubusercontent.com/FusionAuth/fusionauth-install/master/install.ps1 } | iex; install -includeSearch 1
REM Optionally register the service with the following commands
cd fusionauth\fusionauth-app\bin
FusionAuthApp.exe /install

If you run into an error, you may need to change your execution policy. Set-ExecutionPolicy Bypass -scope CurrentUser

Docker

https://hub.docker.com/u/fusionauth/

https://github.com/FusionAuth/fusionauth-containers

Docker Compose

The reference docker-compose.yml defaults to use the database as the User search engine.

In order to install with Elasticsearch as the User search engine, include the reference docker-compose.override.yml.

Review our Docker Install Guide for additional assistance.

curl -o docker-compose.yml https://raw.githubusercontent.com/FusionAuth/fusionauth-containers/master/docker/fusionauth/docker-compose.yml
# Uncomment the following line to install and configure Elasticsearch as the User search engine
# curl -o docker-compose.override.yml https://raw.githubusercontent.com/FusionAuth/fusionauth-containers/master/docker/fusionauth/docker-compose.override.yml
curl -o .env https://raw.githubusercontent.com/FusionAuth/fusionauth-containers/master/docker/fusionauth/.env
docker-compose up

Docker Images

FusionAuth App (On Docker Hub)

docker pull fusionauth/fusionauth-app

When running FusionAuth in Docker with Elasticsearch as the User search engine, it is recommended to either connect to an external Elasticsearch service, or use the Docker images provided by Elasticsearch. See the reference docker-compose.yml and docker-compose.override.yml in the fusionauth-containers repository for an example in configuring Elasticsearch with FusionAuth.

Documentation

https://fusionauth.io/docs

Development

The install scripts must be compatible with CentOS, Ubuntu, Windows and macOS.

Ubuntu, Centos, and Windows testing have been automated via vagrant, go to the respective directory and run vagrant up. Once the VM has started you should be able to reach FusionAuth to perform any required testing. If you want to use a host machine database, the hosts IP address is 10.0.2.2 inside of the guest.

To test a system go to the related directory and run vagrant up. You can then visit http://localhost:9011 in your browser and see if FusionAuth started up properly.

macOS could potentially be tested the same way, but the vagrant boxes aren't legally allowed to be distributed this way, so you would have to make your own.

fusionauth-install's People

Contributors

Stargazers

Watchers

Forkers

etsangsplk vireshmahajan ndaxlo ediboko1980 jerryhopper pks-os derintolu alejandrosuarez vcampitelli

fusionauth-install's Issues

Startup script needs to have curl handle redirects

I had to add -L to the curls in fusionauth/bin/startup.sh in order to boot the server

curl ${CURL_OPTS} "${DOWNLOAD_URL}"  -L -o "${JAVA_DIR}/openjdk-macos-${JAVA_VERSION}.tar.gz"

Because the tar if downloads was a 'you have been redirected' page. Couldn't find it in the repo though, so made an issue 👍🏻

Error while starting fusionauth-app v1.1 post upgrade

INFO: An exception was caught and reported. Message: java.lang.ClassNotFoundException: org.primeframework.jwt.Signer
java.lang.TypeNotPresentException: Type org.primeframework.jwt.Signer not present

I previously did upgrades 1.0.15 -> 1.0.18, was working perfectly alright.

Default to only down app bundle and default to db search engine

Beginning in version 1.16.0, db search will be default and we can modify the fast path to only download the search bundle if requested.

Tasks

add flag to install scripts to ask for search, default will be no
update fast path install guide in doc
update readme here to provide examples of how to call it
review download page on brochure site to see if it needs changes

404

When I trying to execue the scripts (windows and linux), I am getting a 404 error. Same happens when I try to download directly from the website.

PS C:\develop\fusionauth> iex (new-object net.webclient).downloadstring('https://raw.githubusercontent.com/FusionAuth/fusionauth-install/master/install.ps1')
Install FusionAuth version 1.0.0
Installing zip packages
Downloading archive, destination C:\develop\fusionauth\fusionauth
Start-BitsTransfer : HTTP-Status 404: Die angeforderte URL ist auf diesem Server nicht vorhanden.
In Zeile:20 Zeichen:9
+         Start-BitsTransfer -Source $uri -Destination $tempFile
+         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidOperation: (:) [Start-BitsTransfer], Exception
    + FullyQualifiedErrorId : StartBitsTransferCOMException,Microsoft.BackgroundIntelligentTransfer.Management.NewBitsTransferCommand

PS C:\develop\fusionauth>

Optionally download Java on aarch64

See example modification:
https://github.com/jerryhopper/fusionauth-install/blob/master/install.sh

# Expirimental Aarch64 support.
    # Uses https://adoptopenjdk.net/releases.html?variant=openjdk14&jvmVariant=hotspot
    # tested on NanoPi Neo2 (1gb) using Dietpi (www.dietpi.com)
    if [ "$(uname -m)" = "aarch64" ]; then 
      echo "Aarch64 detected, downloading java for aarch64  (Expirimental)"
      # Since we detected ARM, remove the preinstalled jdk.
      rm -rf /usr/local/fusionauth/java/jdk-14.0.1+7
      # Download the aarch64 java
      curl -fSL --progress-bar -o /usr/local/fusionauth/java/OpenJDK14U-jdk_aarch64_linux_hotspot_14.0.1_7.tar.gz "https://github.com/AdoptOpenJDK/openjdk14-binaries/releases/download/jdk-14.0.1%2B7/OpenJDK14U-jdk_aarch64_linux_hotspot_14.0.1_7.tar.gz"
      # Unpack the tarball
      tar -zxvf /usr/local/fusionauth/java/OpenJDK14U-jdk_aarch64_linux_hotspot_14.0.1_7.tar.gz -C /usr/local/fusionauth/java
      # Remove the tarball
      rm -rf /usr/local/fusionauth/java/OpenJDK14U-jdk_aarch64_linux_hotspot_14.0.1_7.tar.gz
    fi

gzip: stdin: not in gzip format tar: Child returned status 1 tar: Error is not recoverable: exiting now

I installed FusionAuth via:
sh -c "curl -fsSL https://raw.githubusercontent.com/FusionAuth/fusionauth-install/master/install.sh | sh -s - -z -s"

However, when I try to run the bin/startup.sh, I get this:

% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   688  100   688    0     0   2166      0 --:--:-- --:--:-- --:--:--  2170

gzip: stdin: not in gzip format
tar: Child returned status 1
tar: Error is not recoverable: exiting now

What's the problem?
(I'm not familiar with linux and am just trying to set-up FusionAuth in a share Node.js host)