Enterprise Manual Installation under Linux
The recommended way to install SwiftyBeaver Enterprise is via Docker. If you can’t install it that way then you can also do a manual installation under Linux which is explained on this page.
SwiftyBeaver Enterprise has a low memory and system footprint and does not require any additional packages to be installed. It can even be run under Alpine Linux and of course also is working under any modern Linux distribution like Ubuntu, Fedora, Arch, etc.
1. Download Server
Download the binary to a folder of your choice, make it executable and run it as privileged user.
curl -L https://lodge.swiftybeaver.com/dl/SBEnterprise -o SBEnterprise chmod +x SBEnterprise
2. Set Environment Variables
SwiftyBeaver Enterprise requires certain environment variables to be set before the server is started. You can do that all in one line or to make it easier to read line by line. Please read environment variables to learn more about the details:
APPS="app1|secret1|89FM6o7mBUmTDjxTBiEJCrKAxaQVXsxr,app2|secret2|q9eZ9FuaqXWaQnVeFZPQq2zVVrdfmC4b" ES_HOST="http://YourElasticSearchHost:9200" ES_AUTH_USER="elastic" ES_AUTH_PASSWORD="changeme"
3. Run Server
Now when all environment variables are set the running of the server is a simple call:
The SwiftyBeaver Enterprise will start in a blocking way which makes it easier to see any issues during startup.
4. Test Server Response
From another SSH connection to the same server you can see if it works properly:
# Unprotected ping connection to see if server is running curl "http://localhost:8080/ping" # Basic Auth protected call to the server using app credentials curl "http://localhost:8080/api/status" -u 'app1:secret1'
You can now add your server's public IP and port and one of the two app credential sets to your SBPlatformDestination() in the SwiftyBeaver Logging Framework inside your mobile app. Read here to learn more about that.
Good to know:
It is recommended to run SwiftyBeaver Enterprise as an auto-restarting daemon in the background. Please follow your Linux distribution’s way of daemonizing a server application to implement it.
To make your SwiftyBeaver Enterprise server production-ready please read the setup instructions for a high availability setup behind a load balancer next.