🚀 Getting Started
Let's get started with SwiftWave! Let's first install SwiftWave on your server. Because without SwiftWave, you can't deploy your applications. 😅
📦 Pre-requisites
- A Virtual Server with Debian, Ubuntu, Fedora OS or their derivatives installed.
- Virtual Server should have at least 1GB RAM and 1vCPU.
- Install curl, git, unzip and tar utilities.
# For Debian/Ubuntu based distros:
sudo apt update -y
sudo apt install curl git unzip tar nfs-common -y
# For Fedora based distros:
sudo dnf install curl git unzip tar nfs-utils - Install docker (Skip this step if you already have docker installed)
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh📌 Note: As RHEL doesn't support docker, SwiftWave doesn't support RHEL based distros.
- You are all set! 🎉
📥 Installation
-
SSH into your server.
-
Download SwiftWave binary
- For AMD64 Architecture
curl -L https://github.com/swiftwave-org/swiftwave/releases/download/1.0.5/swiftwave-1.0.5-linux-amd64.tar.gz -o swiftwave.tar.gz
- For ARM64 Architecture
curl -L https://github.com/swiftwave-org/swiftwave/releases/download/1.0.5/swiftwave-1.0.5-linux-arm64.tar.gz -o swiftwave.tar.gz
- For 386 Architecture
curl -L https://github.com/swiftwave-org/swiftwave/releases/download/1.0.5/swiftwave-1.0.5-linux-386.tar.gz -o swiftwave.tar.gz
-
Extract the gzip archive
tar -xzf swiftwave.tar.gz
-
Make swiftwave binary executable
chmod +x swiftwave
-
Move swiftwave binary to /usr/bin
sudo mv swiftwave /usr/bin/swiftwave
-
🕒 Time for setup!
-
Initialize Docker Swarm
sudo docker swarm init
-
Initialize SwiftWave configuration. Run following command and provide required information.
sudo swiftwave init
-
Prepare Environment for SwiftWave
sudo swiftwave setup
-
Run Local Postgres Database
sudo swiftwave postgres start
-
Migrate Database Tables
sudo swiftwave db-migrate
-
Generate SSL certificate for primary domain
sudo swiftwave tls generate-certificate
tipIf you are installing in a system which doesn't have any public ip, then you can skip this step and disable tls.
Run the following command to disable tls.
Disable TLSsudo swiftwave tls disable
-
Start HAProxy Service
sudo swiftwave haproxy start
-
Start UDP Proxy Service
sudo swiftwave udpproxy start
-
Start SwiftWave Service
sudo swiftwave service enable
-
Enable auto updater for SwiftWave
sudo swiftwave auto-updater enable
-
Enable auto renew service for service TLS certificates
sudo swiftwave tls auto-renew enable
-
Create a new admin user
sudo swiftwave create-user --username <give_a_username> --password <give_a_strong_password>
-
🎉 Congratulations! SwiftWave is now installed on your server.
-
You can now access SwiftWave at
https://<your_domain>:3333
You have forget or missed the auto-generated domain 😅 anyhow ? This is how you can get it back.
- Suppose your server IP is
3.5.12.13
, then your domain will beip-3-5-12-13.swiftwave.xyz
- You have added a custom domain
example.com
, then you can use that domain to access it on https://example.com:3333. - Other way is open the config file by this command
and check the
sudo swiftwave config -e vim
service.address_of_current_node
field in the config file.