🚀 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-utilsInstall 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 commandand check the
sudo swiftwave config -e vim
service.address_of_current_node
field in the config file.